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PREFACE 



This publication is a reference to the Interactive Productivity 
Facility and the facilities available through its use. It includes 
specific information that you may require as you use the Interactive 
Productivity Facility. 

It discusses primarily the VSE implementation of the Interactive 
Productivity Facility, but also includes information about the 
differences between the VSE implementation and the VM/VSE 
implementation. Information for users of the VM/VSE Feature is 
highlighted as follows: 

[VH/VSB FEATURE HOTE] 

For more information on the VM/VSE Feature, refer to the VM/VSE 
Feature Program,, Directory^ the interactive .Productivity Facility VSE 
Feature User's Guide, and the VSE System_IPO/E Planning Guide,, and to 
the VM/SP System IPO/E documents listed below. 



CONTENT 

This publication consists of four sections: 

Section 1 - Debugging Information discusses steps to take in problem 
determination should an Interactive Productivity Facility dialog fail. 
It also lists, with their meanings, error codes and abend codes that 
might be encountered when running Interactive Productivity Facility 
dialogs. 

Section 2 . - Dialog Descriptions describes at a detailed level the 
dialogs of the Interactive Productivity Facility. 

Section 3 - User Options Files explains how the initialization 
tables are used and contains listings of the tables. 

Section 4 - SOB VSE Requirements discusses the virtual machines and 
the SUB$VSET DTRTABLE that are shipped with the VM/vs* Feature of the 
Interactive Productivity Facility. 
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This publication also includes three appendixes. 

Appendix A - Service Library Fall Problems discusses the problem of a 
full service library and the methods you can use to bypass this 
problem. 

Appendix B - Debugging ABEND DM09 discusses the methods you can use to 
debug ABEND DM09 under VSE/ICCF. 

Appendix C - Security and the Interactive Productivity Facility 

discusses the methods you can use to increase security of the 
Interactive Productivity Facility. 



PBBREQOISITE KH0WL2DGE 

You should have a basic understanding of the Interactive Productivity 
Facility as can be acquired from the I nteracti ve Productivity. Facility 
VSE_ Feature User «s_ Guide listed below. 

If you are using VSE/ICCF, you should have a basic understanding of 
VSE/ICCF since the Interactive Productivity Facility operates under 
the control of VSE/ICCF. If you are running Interactive Productivity 
Facility under VM/CMS, you should have a basic understanding of 
VM/CMS. Refer to the VM/SP documents listed below. 



iv Interactive Productivity Facility Reference 



RELATED RBADIIG 

Listed below are the form numbers and titles of publications to which 
you can refer for more information. 

Interactive Productivity Facilitv <5748-MS1) 

GH20-2492 VSE Feature General Information Manual 
GH20-5527 Programming Specifications 
GX20-2383 VSE Feature Reference Summary 
SH20-5526 VSE Feature User's Guide 
SX20-2346 Program Function Key Template for 3277 
SX20-2355 Program Function Key Template for 3276/3278 
none VM Feature User's Guide 

VSE System IPO/B (5750-AAA, 5750-HB, 5750-1AC) 

GC20-1935 General Information Manual 
GC20-1936 Planning Guide 
GC20-1933 User's Guide 

none VM/VSE Feature Guide 

none IPO/E Program Directory 

none IPO/E Reference Guide 

none IPO/E Communication Guide 

f SB/ICCF I5746-TS1) 

GC33-6065 Specifications 

GC33-6066 General Information 

GX33-9006 Reference Summary Card 

SC33-6067 Installation and Operations Reference 

SC33-6068 Terminal User's Guide 

SC33-6069 Messages 

¥H/SP System IPO/E f 5750-AAK) 

GC20-1890 General Information Manual 
GC 20- 1874 Planning Guide 
none Program Directory 
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SECTION 1 - DEBOGGIHG IHFORMATION 



[YH/?SS FEATURE 10TB] In the VM/VSE environment, all members used by 
the Interactive Productivity Facility such as panels, tables, 
skeletons and function routines reside in VM/CMS files. The dialog 
manager runs under VH/CMS and logs the errors to the VM/CMS file. 
The VM/VSE Feature user should refer to the section 'Interactive 
Productivity Facility Errors' in the Interactive P roductivity 
F acility VM Feature Oser's Guide for debugging information. 



PROBLEM DETEBHIHATIOH 

If an Interactive Productivity Facility dialog should fail, there are 
some steps you can take to aid in problem determination. The first 
thing to do is to carefully record everything you entered on the 
| screen, any message that appeared on the screen, the name of the 
| panel being displayed, and the menu selection that invoked the 
I function currently being executed. The name of the panel can be found 
in the upper righthand corner. It is in the form XXX$YYY, where XXX 
is three alphabetic characters and YYY is zero to three alphanumeric 
characters. Save this information. You may need it later. 

If you have a failure that creates an error log entry or abend 
condition, the failure is obvious when it happens. However, it is 
possible that a dialog may appear to complete successfully but not 
produce the correct output. There is one such condition that you can 
and should correct. That is the case when VSE/ICCF is abnormally 
terminated or canceled while a dialog is still running. When this 
termination takes place under VSE/ICCF while the Interactive 
Productivity Facility is in the process of updating a file, the 
VSE/ICCF "update in progress" indicator is left set on. If this 
should occur, the dialog will appear to complete successfully, but no 
output will be written in your library. If this happens, use the 
VSE/ICCF /PROTECT command to reset the indicator. The error log 
record will contain the name of the member that needs to be reset, 
even though no message was sent to indicate that the error log was 
written. 

This type of condition can occur only if VSE/ICCF is terminated 
abnormally. If VSE/ICCF is terminated normally, this situation will 
not occur. If incorrect or incomplete output is produced under any 
other condition, you should report the problem to the IBM Support 
Center. 

If a message appears telling you that an error had been logged, you 
should next look in the error log. You will note that the error log 
will tell you what happened, but not why. 
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ERROR LOG RECORD 

When an Interactive Productivity Facility service routine returns to 
the dialog manager, the dialog manager checks for an error return 
code. If there is an error, the dialog manager logs the error and 
returns to the dialog with a return code of 999. 

If such an error occurs, you will receive the following message on 

I your terminal: 

I 

| ABEND. BBFEB TO ERROR LOG RECORD DESCRIBED IN REFERENCE MANUAL. 

I 
and a file will be created on your VSE/ICCF user library containing 
information about the error. The name of the file is DTR$ELOG. The 
error information contained in this file should be used to diagnose 
the problem. 

Note: In previous versions of the Interactive Productivity Facility 
the error message shown above was displayed with the text 

ERROR HAS BEEN LOGGED WHILE EXECUTING A FUNCTION. 

or 

FUNCTION ABENDED. REFER TO ERROR LOG RECORD DESCRIBED IN USER'S 
GUIDE. 

When you terminate the Interactive Productivity Facility, the current 
contents of DTR$ELOG will be added to the member IPFLOG in your 
VSE/ICCF library. You will also have the opportunity to review 
debugging information concerning any errors logged during the last 
session. Each time the interactive Productivity Facility dialog 
manager is initialized, the DTR$ELOG from any previous session is 
purged. Errors from previous sessions ate stored in IPFLOG* You 
should review the contents of IPFLOG occasionally and purge the 
member when it is no longer required. 

The record written to the error log is taken from the user 
communications area (UCA) of the dialog manager. This record is set 
up by the service manager on each call from a dialog, and contains: 

• The name of the service currently executing 

• The name of the dialog invoking the service manager 

• The line number in the dialog corresponding to the call 
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At the time an error occurs, the following information is added to 
the error log: 

• The name of the routine logging the error 

• A unique code describing the error 

If the error involves a disk I/O operation, the name of the file in 
guestion is also logged. 

The following is a full description of the format and contents of the 
error log: 



FIELD DESCRIPTION 



NAME OF CURRENT SERVICE 
NAME OF INVOKING FUNCTION 
LINE NUMBER OF INVOKING FUNCTION 
NAME OF ROUTINE DETECTING ERROR 
ERROR CODE UNIQUE TO DIALOG MANAGER 
CURRENT LINE NUMBER OF DISPLAY PANEL 
CURRENT COLUMN NUMBER OF DISPLAY PANEL 
VARIABLE VALUE FROM DISPLAY PANEL 
CURRENT RECORD NUMBER OF FILE IN ERROR 
ERROR CODE OF INTERACTIVE SUBSYSTEM 
FILE NAME OF FILE IN ERROR 
FILE TYPE OF FILE IN ERROR 
FILE MODE IF CMS IMPLEMENTATION 



RCD POS 


FIELD NAME | 


1-8 


UCASERV | 


10-17 


UCAFUNCT | 


18-21 


UCAERLNO | 


23-30 


UCAERRTN | 


32-35 


UCAERCD | 


37-38 


UCAERCL | 


40-41 


UCAERCC | 


43-50 


UCAERVV | 


51-54 


UCAERCR | 


56-59 


UCAERSYS | 


61-68 


UCAERFN | 


70-77 


UCAERFT | 


79-80 


UCAERFM | 



I 



Figure 1. Error log record format 



If you enter the debugging session at Interactive Productivity 
Facility termination, the information above will be displayed on your 
screen, along with the IPFLOG (positioned at the last session errors) 
and a file containing all Interactive Productivity Facility error 
codes (positioned at the first error that occurred) . 



ABEND COSDITIOHS 



Certain errors cause the dialog manager to terminate itself rather 
than return to the dialog. This action is taken only if continued 
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operation is impossible, if a dialog abends, you will have to address 
the problem in a slightly different manner from a logged error- In 
the case of an abend, you may or may not have an error log entry 
depending on what caused the failure. If the abend was accompanied 
by an interactive Productivity Facility abend code in the form DMnn, 
then the abend was controlled (i.e. , the CANCEL macro was issued), 
and an attempt was made to write the error log. The abend code DMnn 
will appear as a one-line message on an unformatted VSE/ICCF screen. 
If the abend was uncontrolled, or a controlled abend was unable to 
write the error log, no error log record is available to help you. 

If the Interactive Productivity Facility was unable to write the 
error log, you may still find the error log record it was attempting 
to write by looking in the dump. The record can be found x'FQ' bytes 
into the user control area (UCA). Register 10 should be pointing to 
the UCA. 

Where there is no error log or the UCA has been damaged, or the 
contents of reigister 10 have been lost, debugging must proceed as 
with any other program. The first step is to identify the failing 
component. 

The Interactive Productivity Facility is made up of a dialog manager 
and a number of accompanying function routines. The dialog manager 
is always present in storage. The function routine involved is 
determined by what was selected from the last menu panel before the 
failure. When an item from a menu is selected, the dialog manager 
either displays another menu or loads a function routine and branches 
to it. If the failure occurred while a function routine was active, 
both the function routine and the dialog manager will be in storage. 

All working storage is allocated dynamically* All program storage is 
static. If the dialog manager attempts to load a function routine 
that is too large to fit into the statically allocated program 
storage the Interactive Productivity Facility will abend with a code 
of DM02. The VSE System IPO/E system has set the static storage 
allocation so that it is large enough to hold any Interactive 
Productivity Facility function routine. This allocation is 
determined by the /OPTION statement in the VSE/ICCF procedure 
IPFPfiOC. If a function routine is made larger for any reason 
(service for example) it is possible that the static limit will be 
exceeded. If this occurs, the limit must be raised. Normally, you 
will be notified via the appropriate service documentation if this 
change needs to be made. 

The dynamic storage requirement, however, is a function of the use 
being made of the Interactive productivity Facility and the sizes of 
the internal tables being handled by the function routine. If the 
dynamic storage limit is exceeded, the interactive Productivity 
Facility may or may not abend depending on the conditions under which 
the attempt to get more storage failed. In most cases, this error 
will be logged. Some cases, however, will resiilt in an abend code 
DM02. This happens when the dialog manager cannot proceed without 
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more storage. If this occurs, you will have to give the dialog 
manager more storage. 

Since most dialogs result in one or more members being expanded or 
added to the library, there is always the possibility that you will 
run out of library or directory space. If this happens the dialog 
manager will abend with a code of DM08. In this case you must either 
delete something in the library, run a backup/restore, or allocate 
more space. If you run out of space shortly after your last 
backup/restore, you should start planning to allocate more space. 

If you do encounter an abend condition, take the following action 
before calling the IBM Support Center: 



f 



Record all the information you can. 

- The name of the dialog you were running 

The name of the last panel that appeared (if you know it) 

- The abend code 

- Any other information that appears on the screen 

Try to save something in your library <to make sure your 
library or directory isn't full. If not: 

- Record the contents of the error log, if any. 

- List the procedure IPFPROC and record the contents of the 
/OPTION statement. 

Prom the VSE System IPO/E system console, execute the /MAP 
command and record the pseudopartition information displayed, 
record the pseudo partition information displayed. 



Figure 2. Suggested abend condition action 

If there is no error log record, you will need a dump. You can 
specify that you want a dump in the /OPTION statement in IPFPROC. 
Add ,DUMP after the last parameter already ox the /OPTION statement. 
The next abend will produce a dump on your VSE/ICCF terminal. If you 
want to save the dump, you may do so with the SAVE command of the 
VSE/ICCF dump program. If you use this command, remember to put in 
some identifier information so that you can locate the dump later. 
f 'se the VSE DOSVSDMP utility program to print the dump. 
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I - *- is very important that you have as much information as possible 
about your problem before calling the IBM Support Center. The more 
information you are able to give them, the sooner they will be able 
to respond to your problem. 
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I HTBR ACTIVE FBODOCTIVIfl FACILITY ERROR CODES 



The following error codes may be encountered when running Interactive 
Productivity Facility dialogs. See the Interactive Productivity 
Facil ity Program Logic Microfiche (LYBO-2579) for more detailed 
information. 

I £YH/?SB FEATURE Hoxtf] Codes CLnn, IOnn, and SCnn will not occur in 
I the VM/VSE environment because they are caused by errors in 
I communicating with VSE/ICCF* 



I Interactive Productivity Facility Error Codes (VSE Feature) 

i ; ; ; ; . i . 



CLOT Recursive call. Program attempted to call itself. 

CL02 Called program was not found. 

DP01 Invalid call to display service. 

DP02 A panel display reguest was made, but the panel file, or a 

valid header record within the panel file, could not be found. 
The name of the panel file in error is in UCAERFN. 

DP04 Error substituting a variable from the function routine into 
the panel. The variable value in error is in field UCAERVV. 

DP05 Error processing synonym table for MOREINFO synonym. 

DP06 Error decoding panel. 

DP07 Error analyzing panel. 

FO01 The page number of the current page of an explain panel is not 
numeric. 

FO02 The page number of the last page of an explain panel is not 
numeric. 

FO03 End o$ file was detected on the panel file while attempting to 
read a directions record. 

FO04 End of file was detected on the panel file while attempting to 
reset the current record pointer after a directions record not 
found condition. 

FO05 End of file was detected on the panel file before a full panel 
could be built. 
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FO06 The output line created was too long to display on the screen. 

FO07 End of file was detected on the panel file while attempting to 
reset the current record pointer after looking for an explain 
record* 

FO08 The maximum number of menu selection items (16) was exceeded. 

FO09 Invalid field structure on light-pen detectable field. 

FOIO Syntax violation. First character of high intensity field is 
blank. 

F011 Variable name in text field is longef that eight characters. 

F012 Syntax violation. Invalid attribute byte. 

F013 The maximum number of data entry fields on a single panel (30) 
was exceeded. 

F014 The length specification for an EXEC-2 variable was either 
nonnumeric or less that one or greater than 80. (Actual 
maximum length is 72 for EXEC-2 variables) 

F015 The length specification for a non-EXEC-2 variable was either 
nonnumeric or less than one or greater than 8. 

F016 Variable name in a data entry field is longer than eight 
characters. 

F017 Invalid delimiter found. 

F018 The maximum number of D-entry fields on a single untokenized 
data entry panel (16) was exceeded* 

F019 The length specification for an EXEC-2 variable was either 
less than one or greater than 72. 

FT02 The output work file has not been initialized with SKEDIT. 

FT03 The file specified via SKINCL or ) IM control statement does 
not exist. 

FT04 ) ENDSEL encountered without a corresponding )SEL. 

FT05 The generated output record is too long. 

FT06 A control statement with an invalid control word has been 
encountered. 

FT07 A control statement with an invalid parameter has been 
encountered* 



8 
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FT08 An invalid variable name was encountered. 

FT09 More than 3 )IM levels encountered. 

FT10 More than 8 ) SEL levels encountered. 

FT11 End of input file was detected after an input record with ? in 
column 72 (i.e., the continuation record is missing). 

FT 12 A syntax error has been detected in a conditional substitution 
string. 

FT13 An incorrect parameter list was passed to a file tailoring 
service routine. 

FT14 An input file ended in a different ) SEL block from the one 
that existed when the input file began. 

FT15 An input file ended in a different ) DOT block from the one 
that existed when the input file began. 

FT16 )ENDSEL encountered in a different input file from the one in 
which the corresponding ) SEL appeared. 

FT17 ) END SEL encountered in a different ) DOT block from the one in 
which the corresponding ) SEL appeared. 

FT18 More than 4 )DOT levels encountered. 

FT19 )ENDDOT encountered without a corresponding )DOT. 

FT20 ) ENDDOT encountered in a different ) IN file from the one in 
which the corresponding ) DOT occurred. 

FT21 ) ENDDOT encountered in a different ) SEL block from the one in 
which the corresponding ) DOT occurred. 

FT22 Table specified in ) DOT statement does not exist. 

FT23 Invalid relational operator encountered in ) SEL statement. 

FT24 Invalid boolean operator encountered in ) SEL statement. 

FT25 Invalid operator encountered in )SET statement. 

FT26 An attempt has been made, via the )DOT statement, to process a 
table that is already being processed via a )DOT statement 
with no intervening ) ENDDOT. 

G?01 Variable not found in function routine. 

IO01 Command list ABEND. The file is closed, and the dialog 
manager is terminated. 
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1002 File not open. 

1003 A READ request was issued for an update file that has not been 
created yet; or a WBITE request was issued for a file that was 
opened for input only. In either case, the file is closed. 

1004 Invalid file name. 

1005 A WRITE request, other than a sequential WRITE request, was 
issued. The file is closed. 

1006 No free file I/O control blocks available. More storaqe is 
needed. 

IO08 A WRITE request was issued for a blank output record. 

1010 Library directory is full. The file is closed. 

1011 Library file is full. The file is closed. 

1012 VSE/ICCF "Input full - Input Ignored" condition encountered. 
The file is closed. 

1013 VSE/ICCF "Input Ignored" condition encountered. The file is 
closed. 

1014 VSE/ICCF "Update in Progress" condition encountered. The file 
is closed. 

1015 VSE/ICCF "Invalid User Access" condition encountered. The file 
is closed. 

1099 Catastrophic error. The file is closed, and the dialog manager 
is terminated. 

LB01 Invalid calling sequence. 

H601 Invalid calling sequence to SETMSG routine. 

H602 Message file does not exist. 

HG03 Message record does not exist. 

H604 Completed message more than 70 characters. 

■605 Message record read is invalid. 

HG06 Unrecoverable logic error in SETMSG routine. 

MV01 Invalid calling sequence to SETMENU service. 
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OP01 Error encountered while processing the options file. The 

record number in error is in field UCAERCR. The dialog manager 
is terminated. 

OP02 Input file for TEST option was not found. The dialog manager 
is terminated. 

OP03 Error encountered reading the initial panel file, or file not 
found. The dialog manager is terminated. 

OP04 DSPTABLE file not found. The dialog manager is terminated. 

SC10 Invalid input buffer length. 

SC11 GBTVIS request failed. 

SH01 Invalid call to service manager. Number of parameters exceeded 
allowable maximum of 18. 

SH02 Service requested is not a valid dialog manager service. The 
invalid service is logged in field UCASERV. 

SP01 A special variable was not found in the synonym table. The 
special variable not found is logged in field OCAERVV. The 
dialog manager is terminated. 

ST01 Error obtaining virtual storage. 

S?01 Variable cannot be set. This error can occur in VSE/ICCF if 
the variable overflow area has been completely used. More 
storage is needed. 

TB01 Twenty tables are already being processed. There is no room 
to process another one. 

TB02 An invalid table name has been passed as a parameter to a 
table processing service routine. 

TB03 An invalid descriptor row was read while preparing a table for 
processing. 

TB04 An invalid data row was read while preparing a table for 
processing. 

TB05 An invalid variable name encountered while processing a table. 

TB06 Table does not exist. 

TB07 The specified table has not had the TEDIT service issued in 
order to prepare it for processing. 

TB08 An incorrect parameter list was passed to a table processing 
service routine. 
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TB10 Invalid descriptor value was specified for TCREATE service. 

TB11 Invalid skip parameter specified for TSKIP service. 

XX01 Invalid operand in arithmetic statement. 

XI02 Result of arithmetic operation is invalid. 

XX03 Invalid length or index in SUBSTR request. 

XX04 Variable could not be found. 

I 

I XX05 A function routine could not load module DTSCLPRC or module 

I DTSCLPRP. 



12 



Interactive Productivity Facility Reference 



INTERACTIVE PRODUCTIVITY FACILITY ABEND CODES 

The following codes are not logged in the error log record. They 
appear as one-line messages on an unformatted VSE/ICCF screen. They 
do not appear on Interactive Productivity Facility panels. 

I [VH/VSE FEATURE IOTE] Codes ATnn, DM07, DM08, and DM09 will not 

j occur in the VM/VSE environment because they are caused by errors in 

I communicating with VSE/ICCF* 



I Interactive Productivity Facility Abend Codes (VSE Feature) 

i 



AT01 Initial GETVIS for the FCB failed. 

IT02 GETVIS for the initial PCB failed. 

AT03 The root phase (first phase to be loaded) was too large for 
the allocated problem program storage area. 

A TO 4 Insufficient storage to build I/O area for error message. 
Forces system dump. 

AT05 The called phase (phase to be loaded) was too large for 
allocated problem program storage area. 

DH01 Requested service was not initialized, and there is no UCA. 

DH02 An error occurred while attempting to log an error. 

DB03 An error occurred while attempting to use the system message 
file. 

DM04 An unrecoverable error occurred. Refer to the error log. 

DM05 No free storage available for required dialog manager control 
blocks. 

DH06 Unrecoverable logic error occurred. 

| DM07 The dialog manager could not load module DTSCLPRP. 

DM08 The VSE/ICCF library (DTSFILE) is full. 

( DM09 ^Invalid command message received from VSE/ICCF. See Appendix 
* B - Debugging ABEND DM09. 
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SECTIOH 2 - DIALOG DESCRIPTIONS 



This section describes in detail the dialogs of the Interactive 
Productivity Facility. The following information is provided for 
each dialog: 



DIALOG: 

This is the name of the dialog as contained in the core image library. 

DIALOG BAHB: 

This is the title of the dialog as contained on the menu panel that 
invokes the dialog. 

PREREQUISITE DIALOGS: 

This is a list of any Interactive Productivity Facility dialogs that 
must be run before this one will work correctly. 

Mote: ADM$FST is required for most Interactive Productivity Facility 
dialogs and is not listed individual^ on each dialog description. 

DEFAULT JOBBAHE CHEATED: 

This is the name under which the output JCL will be filed in your 

primary library area. 

OTHER YSB/ICCF MEMBERS CREATED: 

Some of the Interactive Productivity Facility dialogs create internal 
members that are filed on your primary library* These members are 
listed here. If they are in parenthesis, they may or may not be 
generated, depending on user responses. 

[VH/VSE FEATURE BOTE] In the VM/VSE environment, the members 
listed here are filed on your CMS disk. 

DIALOG DBSCRIPTIOB: 

This is a description of the dialog function. 

JCL DBSCRIPTIOB: 

This is a description of the JCL that the dialog produces and what 
functions it will perform when executed. 



Figure 3. Information provided by dialog 
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The following listings are included to help you find the dialog 
description you want. The first chart lists the dialogs by 
descriptive title as you would find it on the menu that invokes the 
dialog. The second chart lists the dialogs by menu hierarchy. Each 
chart includes the page number where the dialog description is 
located. 



DIALOGS LISTED BY DESCRIPTIVE TITLE 

Dialogs Listed by Descriptive Title 
Dialog Title Dialog Description 



i 



Add CICS/VS User 


Page 23 


Add Mew Library Set 


Page 22 


Add Software Product 


Page 41 


Add Terminal 


Page 104 


Add VSE/ICCF User 


Page 43 


Alter Cluster 


Page 48 


Alter Core Image 


Page 73 


Alter Relocatable 


Page 74 


Alter Source 


Page 74 


Apply Backout PTF 


Page 82 


Apply Cumulative PTF 


Page 80 


Apply PTF 


Page 78 


Apply PUT 


Page 84 


Apply Selective PUT 


Page 91 


Archive APAR Fix 


Page 70 


Archive PTF 


Page 71 


Assemble/Catalog SltT 


Page 37 


ASI Procedure Tailoring 


Page 100 


Backup History File 


Page 71 


Backup/Restore Library Sets 


Page 24 


Browse Libraries 


Page 25 


Catalog Library Members 


Page 61 


Change CICS/VS User 


Page 27 


Change VSE/ICCF User 


Page 28 


CICS Tailoring: Add Data Set 


Page 101 


CICS Tailoring: Add Program 


Page 103 


CICS Tailoring: Add Transaction 


Page 10 2 


CICS Tailoring: Assemble/Catalog PPT 


Page 118 


CICS Tailoring: Assemble/Catalog PCT 


Page 117 


CICS Tailoring: Assemble/Catalog TCT 


Page 119 


CICS Tailoring: Assemble/Catalog FCT 


Page 116 
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Dialogs Listed by Descriptive Title 



Dialog Title 



Dialog Description 



CICS Tailoring: Change Data Set 

CICS Tailoring: Change Program 

CICS Tailoring: Change Terminal 

CICS Tailoring: Change Transaction 

CICS Tailoring: Delete Data Set 

CICS Tailoring: Delete Program 

CICS Tailoring: Delete Terminal 

CICS Tailoring: Delete Transaction 

Condense History 

Copy Diskette Utilities 

Copy File 

Copy In Catalog 

Copy Out Catalog 

Copy Library Members 

Create Copy Files 

Create Libraries 

Define Catalog 

Define Cluster 

Define Space 

Delete Catalog 

Delete CICS/VS User 

Delete Cluster 

Delete Library 

Delete Library Members 

Delete Space 

Delete VSE/ICCF User 

Dialog Customization 

Display File 

Display Library Members 

Display VTOC Utilities 

Dump Analysis 

EP/VS 

Export File 

Fast Copy: Backup Disk to Tape 

Fast Copy: Copy Disk to Disk 

Fast Copy: Restore Tape to Disk 

FCB Maintenance 

First Time Use 

Generate VSE Supervisor Assembly 

Import File 



Page 


107 


Page 


109 


Page 


110 


Page 


108 


Page 


112 


Page 


114 


Page 


115 


Page 


113 


Page 


72 


Page 


127 


Page 


49 


Page 


46 


Page 


44 


Page 


62 


Page 


26 


Page 


63 


Page 


44 


Page 


50 


Page 


69 


Page 


45 


Page 


29 


Page 


51 


Page 


29 


Page 


64 


Page 


70 


Page 


30 


Page 


47 


Page 


52 


Page 


65 


Page 


130 


Page 


69 


Page 


120 


Page 


52 


Page 


129 


Page 


131 


Page 


133 


Page 


124 


Page 


30 


Page 


123 


Page 


53 
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Dialogs Listed by Descriptive Title 



Dialog Title 



Dialog Description 



Installation Page 58 

I/O Configuration Page 32 

JCL Comments Page 72 

JCL Creation Page 67 

Label Information Page 35 

Library Backup Page 128 

Library Information Page 36 

Library Restore Page 132 

List Catalog Page 45 

Modify Security Table Page 40 

Modify VSE/ICCF Tables Page 34 

Post Assemblies Page 75 

Post Service Rage 76 

Pre Service Page 77 

Print Cover Letters Page 73 

Print File Page 53 

Print Panels (VSE only) Page 125 

Program Development (VSE) Page 68 

POT Library/History Update Page 39 

Remove History Record Page 93 

Rename Library Members Page 66 

Restart PUT Page 89 

Restore History File Page 94 

Retrace History Page 93 

Run Security Reports Page 39 

Select Environment Definition Page 56 
Select Job from SYSIN Tape (VSE only) Page 126 

Software Products Page 42 

Transport Catalog Page 46 

TTF Tailoring Page 38 

Undo Core Image Page 94 

Undo Relocatable Page 95 

Update Environment Definition Page 57 

Update Library Page 43 

Verification Menu Page 134 

Verify File Page 55 

VSE/ICCF Tailoring Page 33 

VSE/POWER Tailoring Page 121 

VSE/POWER/RJE Page 122 
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DIALOGS LISTED BT MEHU HIERARCHY 



Dialogs Listed by Menu Hierarchy 



Menu Hierarchy Information Dialog Description 



System Use (VSE Only) 

Program Development Page 68 
System Management 

System Management Guide 
Administration 

System Administration 

System Profile 

First Time Use Page 30 

I/O Configuration Page 32 

Software Products Page 42 

Add Software Products Page 41 

Create Copy Files Page 26 

Library Information Page 36 

Label Information Page 35 

Logons/Passwords 

Add VSE/ICCF User Page 43 

Delete VSE/ICCF User Page 30 

Change VSE/ICCF User Page 28 

Add CICS/VS User Page 23 

Delete CICS/VS User Page 29 

Change CICS/VS User Page 27 

Assemble/Catalog SNT Page 37 

Librarian 

Display Library Members Page 65 

Delete Library Members Page 64 

Rename Library Members Page 66 

Catalog Library Members Page 61 

Create Libraries Page 63 

Copy/Merge Libraries Page 62 

Backup Library Sets Page 24 
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Dialogs Listed by Menu Hierarchy 



i 



Menu Hierarchy Information Dialog Description 



Restore Library Sets Page 24 
System Tailoring 

Generate VSE Supervisor Assembly Page 123 

ASI Procedure Tailoring Page 100 

VSE/POWER Tailoring Page 121 

VSE/ICCF Tailoring Page 33 

TTF Tailoring Page 38 

Modify VSE/ICCF Tables Page 34 

Modify Security Table Page 40 

Run Security Reports Page 39 

Dialog Customization Page 47 
Utility Aids 

* Select Job from SYSIN Page 126 

* Print Panels Page 125 
FCB Maintenance Page 124 

Data Base Administration 
VSE/VSAM 

Catalog Management 

Define Catalog Page 44 

Delete Catalog Page 45 

Copy Out Catalog Page 44 

Copy In Catalog Page 46 

Transport Catalog Page 46 

List Catalog Page 45 

Space Management 

Define Space Page 69 

Delete Space Page 70 

Data Set Management 

Define Cluster Page 50 

Delete Cluster Page 51 

Alter Cluster Page 48 

Copy File Page 49 

Export File Page 52 

Import File Page 53 

Print File Page 53 

Verify File Page 55 

Display File Page 52 



* VSE/ICCF users only. 
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Dialogs Listed by Menu Hierarchy 



Menu Hierarchy Information 



Dialog Description 



Communication Administration 
CICS/VS Tables 
CICS Programs 

Add Program 
Delete Program 
Change Program 
Assemble/Catalog PPT 
CICS Transactions 

Add Transactions 
Delete Transactions 
Change Transactions 
Assemble/Catalog PCT 
CICS Terminals , lines 
Add Terminal 
Delete Terminal 
Change Terminal 
Assemble/Catalog TCT 
CICS Data Sets, Data Bases 
Add Data Set 
Delete Data Set 
Change Data Set 
Assemble/Catalog FCT 
VSE/POWER RJE 
EP/VS 
Installation 
Verification 
Dump Analysis 
Service 

Apply POT 
Restart PUT 
Apply Selective POT 
Apply PTF 

Print Cover Letters 
Apply PTF from PUT Tape 
Apply Cumulative PTF 
Apply Backout PTF 
Apply APAR/Local 
Pre Service 



Page 
Page 
Page 
Page 

Page 
Page 
Page 
Page 

Page 
Page 
Page 
Page 

Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 
Page 



03 
14 
09 
18 

02 
13 
08 
17 

04 
15 
10 
19 

61 
12 
07 
16 
22 
20 

58 

134 

69 



Page 84 
Page 89 
Page 91 

Page 73 
Page 78 
Page 80 
Page 82 

Page 77 
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Dialogs Listed by Menu Hierarchy 



Menu Hierarchy Information Dialog Description 



Corrective Service 

Alter Core Image Page 73 

Alter Relocatable Page 74 

Alter Source Page 74 

Undo Core Image Page 94 

Undo Relocatable Page 95 

Post Service Page 76 

Archive Fix Page 70 

History Function 

Retrace History Page 93 

Remove History Record Page 93 

Condense History Page 72 

Backup History File Page 71 

Restore History Page 94 

JCL Comments Page 72 
Operations 

JCL Creation Page 67 
VSE Utilities 

Library Backup Page 128 

Library Restore Page 132 

Fast Copy Disk to Disk Page 131 

Fast Copy Disk to Tape Page 129 

Fast Copy Tape to Disk Page 133 

Copy Diskette Utilities Page 127 

Display VTOC Utilities Page 130 
Environment Definition 

Select Environment Definition Page 56 

Update Environment Definition Page 57 
First Use Tutorial 

Introduction Page 95 

Adjusting Screen Page 96 

Exiting Page 96 

Cursor Movement Page 96 

Indicators Page 97 

Management/Use Page 97 

Menu Panel Page 97 

Data Entry Panel Page 98 

Explain Panel Page 98 

Insert/Delete and Erase Page 98 

Other Keys Page 99 

Lightpen Page 99 

Fast Path Page 99 
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DIALOG: ADH$ADD 

DIALOG NAME: Add New Library Set 

PREREQUISITE DIALOGS: ADM$LBR 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to add a new library set to the administrative 
tables. A list of the current library sets and their current 
libraries will be shown and the names of the new library set will be 
entered in the data entry fields. A library set is a logical group of 
libraries, and is composed of a core image, relocatable, and source 
statement library. Library sets for user libraries may consist of any 
combination of the above* Library sets for IBM libraries must have a 
core image library if they will be serviced by the PUT tapes. 

After determining which libraries you wish to add to the new library 
set, you will be asked to supply additional information for each 
library. The information reguired is the file identification, library 
allocation, directory allocation, starting address of the library, 
device type, and volume serial number of the pack where the library 
will be located. 

This dialog is call by function ADM$LBR and is not accessed from a 
menu panel. 

JCL DESCRIPTION: None 
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DIALOG: ADH$ASH 

DIALOG NAME: Ada CICS/YS User 

PREREQUISITE DIALOGS: None 

DEFAULT JOG NAME CREATED: SNT$AST 

OTHER VSE/ICCF MEMBERS CREATED: TCI$SNT1 

DIALOG DESCRIPTION: 

This dialog is used to add users to your CICS/VS system. You may add 
various CICS/VS sign- on table parameters based on the configuration 
of your system. When you complete the adds for as many users as 
desired, they are filed into TCI$SNT. You should consult the CICS/ VS 
System Programmer's Reference Manual (SC33-0069) for a full 
explanation of what each parameter means since the explanation 
provided is only a summary of the information in the manual. 

JCL DESCRIPTION: 

The JCL created by this dialog consists of one job that will add as 
many users as you have entered, plus those that are already in the 
table TCI$SNT1 from previous entries. This table is nonsuffixed so 
that only one sign-on table can exist on your system. The phase will 
be cataloged into USRCL1 (user core image library one) . 
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DIALOG: ADHSBKB 

DIALOG NAME: Back up/Re st or f» Library Sets 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: BACKUP/RESTORE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to either back up or restore your library sets. 
Whether its use is backup or restore depends on the menu item 
selected. You may use this dialog to backup/restore all of your 
production and user library sets, or any combination of individual 
sets. The term set is used to describe core image, relocatable, and 
source statement libraries. Exaaple: The library set for library C 
is: production core image library C, production relocatable library 
C, and production source statement library C. 

The panel, ADM$BKR1, contains entries for all of the possible library 
sets that can be defined in the system profile tables. The first 
entry, PRDXLA, defines the production library set for A. If you enter 
ALL in this field, all of the library sets that exist on your system 
and are described in you system profile will be backed up or 
restored. 

The restore feature of this dialog may also be used to restore a 
library set from a backup taken by the service dialogs. 

JCL DESCRIPTION: 

A single job is produced that contains either a backup or restore 
statement for each library. 
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DIALOG: ADH$BRS 

DIALOG NAME: Browse Libraries 

PREREQUISITE DIALOGS: ADM$LBR 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to display information about currently defined 
user or IBM libraries. The dialog will display one library at a time. 
The information displayed will be the library name, library file ID, 
library description, library allocation, directory allocation, device 
type and volume serial of the pack containing the library, starting 
address of the library, and the number of tracks (or blocks for FBA 
devices) . 

JCL DESCRIPTION: None 
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DIALOG: ADH$CPY 

DIALOG NAME: Create Copy Files 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: (INS$XXXR) , (INS$XXXS) 

DIALOG DESCRIPTION: 

This dialog is used to create copy files. If a particular copy file 
already exists, you can either recreate it, or add new entries to the 
existing file. You will be asked to supply the three-character 
string under which the copy files will be filed. That is, xxx, where 
copy file names are INS$xxxR and INS$xxxS. 

A relocatable copy file is a file that contains statements that are 
used as input to Interactive Productivity Facility dialogs to 
produce COPYR statements. These COPYR statements have module names 
that are the names of product modules that are to reside in the 
relocatable production library. A source statement copy file 
contains input used to produce COPYS statements. These COPYS 
statements have the names of product source statement books that are 
to reside in the source statement production library. 

Dialogs use these files to rebuild the relocatable and source 
statement production libraries after members in the corresponding 
service libraries have been updated. Products that have relocatable 
modules or source statement books that are to reside in IBM 
relocatable or source statement production libraries must have copy 
files. 

JCL DESCRIPTION: None 
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DIALOG: ADHSCSH 

DIALOG NAME: Change CICS/VS Users 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SNT$AST 

OTHER VSE/ICCF MEMBERS CREATED: TCI$SNT1 

DIALOG DESCRIPTION: 

This dialog is used to change sign-on parameters in your CICS/VS 
system. You may change or add various CICS/VS sign-on table 
parameters based on the configuration of your system. When you 
complete as many changes or additions as desired, they are filed into 
TCISSNT to preserve them. You should consult the CICS/VS System 
Programmers Guide for a full explanation of the meaning of each 
parameter, because the explanation provided in the dialog is only a 
summary of the information in the manual. 

JCL DESCRIPTION: 

The JCL created by this dialog consists of one job that makes all the 
changes you have entered plus retains those entries that were in 
table TCI$SNT1 previously. This table is nonsuffixed so that only one 
sign-on table can exist on your system. The library into which the 
phase is cataloged is USRCL1 (user core image library one) . 
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DIALOG: ADHSCSB 

DIALOG NAME: Change VSE/ICCF Users 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: ICCF 

OTHER VSE/ICCF MEMBERS CREATED: ADMlUSRT 

DIALOG DESCRIPTION: 

This dialog is used to change users and libraries in the VSE/ICCF 
system. You may change various VSE/ICCF parameters based on the 
configuration of your system. You enter an existing user and change 
the parameters for that user as they are presented to you. When you 
complete the changes for as many users as desired, they are filed 
into ADM$USRT. Four panels are presented to you for the insertion of 
changes; you should consult the VSE/ICCF Installati on and Operations 
Reference, manual for a full explanation of what each parameter means 
since the explanation provided is only a summary of the information 
in the manual. 

JCL DESCRIPTION: 

The JCL created by this dialog consists of one DTSUTIL job that will 
change as many users as you have entered. In order to run this job 
you must ensure that VSE/ICCF is not running; otherwise, it will not 
enter the changes onto the system. 
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DIALOG: ADHSDEL 

DIALOG NAME: Delete Library 

PREREQUISITE DIALOGS: ADH$LBR 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to delete a currently defined user or IBM library 
from the administrative tables. The dialog will display the current 
library names and allow you to select the library you wish to delete. 
After selecting the library to delete, the dialog will display the 
library name, file ID, description, device type, serial number, 
starting address, and number of tracks/blocks, ai*d ask you if this is 
the library you wish to delete. 

This dialog is call by function ADM$LBR and is not accessed from a 
menu panel. 

JCL DESCRIPTION: None 

DIALOG: ADHSDSI 

DIALOG NAME: Delete CICS/VS Users 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SNT$AST 

OTHER VSE/ICCF MEMBERS CREATED: TCI$SNT1 

DIALOG DESCRIPTION: 

This dialog is used to delete users from your CICS/VS system. You 
are asked the ID of the user you wish to delete from the sign-on 
table. Then a second panel asks you to enter yes or no to delete 
that user. When you complete the deletes for as many users as 
desired, they are filed into TCI$SNT. You should consult the CICS/VS 
System Programmers Gui de (SC33-0069) for a full explanation of what 
each parameter means since the explanation provided is only a summary 
of the information in the manual. 

JCL description: 

The JCL created by this dialog consists of one job that will assemble 
a new SNT with the users deleted and create a new sign-on table that 
has those entries that were not deleted. This table is nonsuf fixed so 
that only one sign-on table can exist on your system. This table is 
cataloged to USRCL1 (user core image library one) • 
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DIALOG: ADH$DSB 

DIALOG NAME: Delete VSE/ICCF Users 

PREREQaiSITE DIALOGS: None 

DEFAULT JOB NAME CREATED: ICCF 

OTHER VSE/ICCF MEMBERS CREATED: ADM$USRT 

DIALOG DESCRIPTION: 

This dialog is used to delete users and libraries in the VSE/ICCF 
system. First, a panel will be presented to you that asks the user 
you wish to delete; then the next panel asks if you want to actually 
delete that user to which you respond yes or no. You may enter an 
existing user and delete that user. You may then complete the 
deletion for as many users as desired. 

JCL DESCRIPTION: 

The JCL created by this dialog consists of one DTSUTIL job that will 
delete as many users as you have entered for deletion. In order to 
run this job, you must ensure that VSE/ICCF is not running; 
otherwise, it will not delete the users from the system. 

DIALOG: ADHSFST 

DIALOG NAME: First Time Use 
PREREQUISITE DIALOGS: None 
DEFAULT JOB NAME CREATED: FIRSTUSE 



OTHER VSE/ICCF MEMBERS CREATED: 
(ADM$HDWT), (TAS$SDl1-40) , 



(ADM$FS30) 

ADM$DTAB, 
ADM$LTAB, 
AMD$PAR3, 
ADM$ULIB, 
LIB$$ASI, 
TAS$ASGX, 
TAS$PWRX, 



ADM$JCL0, 
ADM$PAR0, 
ADM$PROD, 
DTR$PCTI, 
LIB$$DEF, 
TAS$PDSX, 
TAS$SYS, 



ADM$LIB, 

ADM$PAR2, 

ADM$SHIP, 

DTR$PPTI, 

TAS$AR30, 

TAS$PWR, 

TAS$SYSX 



DIALOG DESCRIPTION: 

This dialog is the first dialog to be run after the base install 
procedure has been completed, and the Interactive Productivity 
Facility has been brought up. It is used to create your system 
profile. Tables are created that establish initial defaults for your 
software products, hardware configuration, disk standard labels, and 
libraries. If an I/O configuration table already exists, it can be 
preserved. If a disk standard labels table already exists, it is 
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scanned, and non-System IPO/E supplied entries are added to the newly 
created labels table. 

A series of panels is used to determine which optional products you 
plan to install on your system. This information is used to 
dynamically calculate the amount of DASD space required for certain 
production libraries. These libraries are created based on the 
calculated sizes. 

CICS/VS should be selected only if it is currently installed (that 
is, installed as part of the base installation process) . 

[TM/VSB FEATURE SOTS] If you are a VM/VSE Feature user, you will be 
asked if VSE/ICCF is installed on your system. As with CICS/VS, 
VSE/ICCF should be selected only if it was installed as a part of 
your VSE System IPO/E base. 

A number of System IPO/E supplied tables are tailored during the 
execution of this dialog based on the I PL procedure chosen. The 
additional time required to perform this editing now results in 
faster execution times for later dialogs. 

The following is a list of tables and skeletons produced during the 

execution of the first time use dialog, along with a brief 

description of each: 

ADM$SHIP - System software product profile table 

ADM$PROD - System software product profile table 

ADM$HDWT - System I/O configuration profile table 

ADM$DTAB - System disk label and extent profile table 

ADM$PAR0 - System partition disk label and extent profile table for 

B6 

ADM$PAR2 - System partition disk label and extent profile table for 

F2 

ADM$PAR3 - System partition disk label and extent profile table for 

F3 

ADM$LTAB -• System library profile table 

ADM$LIB . - System production/service library table 

ADM$ULIB - User library table 

TAS$AR30 - Master ASI directory table 

TAS$ASGX - Programmer logical unit assignment table 

TAS$PDSX - Page data set parameter table 

TAS$PWRX - Power device and startup parameter table 

TAS$PWR - work power device and startup parameter table 

TAS$SYSX - Miscellaneous ASI parameter table 

TAS$SYS - Work miscellaneous ASI parameter table 

TAS$SDnn - System directory list tables 

ADM$FS30 - Table indicating the first time use dialog was executed 

ADM$JCL0 - Skeleton of DLBL and EXTENT expansion for standard 

labels 

LIB$$ASI - Skeleton of system LIBDEFs 

LIB$$DEF - Skeleton of system LIBDEFs with DLBL/EXTENT information 
DTR$PCTI - Skeleton containing DFHPCT entries for VSE/ICCF 
DTR$PPTI - Skeleton containing DFHPPT entries for VSE/ICCF 
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JCL DESCRIPTION: 

The JCL created by the first time use dialog contains a job to 
personalize the system history file. This job uses the MSHP 
personalize statement to supply user identification information to 
the general header record of the history file. Another job is created 
to define the required production optional product libraries based on 
the products you indicated will be installed on your system. Finally* 
a job is included to catalog into the system procedure library and 
execute a procedure to establish system LIBDEFs. This procedure 
defines the sequence in which production libraries are to be 
concatenated and accessed , and opens the newly created libraries. It 
can be executed at any time to reset the system LIBDEFs by releasing 
the pause job held in the system reader queue for the desired 
partition (for example, r rdr,PAUSEBG for the background partition) , 
and issuing // EXEC PEOC=LIBDEF preceded by the appropriate partition 
identification (0 // EXEC PROC=LIBDEF for background). If SYSCLB, 
SYSRLB, or SYSSLB are assigned, they must be unassigned before 
executing the proc (0 ASSGH SYSCLB, 0A for SYSCLB assigned in 
background). The job is concluded by entering the partition 
identification (again, for background). 

DIALOG: ADHSHDi 

DIALOG NAME: I/O Configuration 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: (At>M$HDWT) 

DIALOG DESCRIPTION: 

This dialog is used to examine and maintain a profile of the local 
I/O devices attached to your system. It is possible to add, update, 
or delete a single entry in your I/O configuration profile table 
through the UPDATE activity based on the DEVICE ADDRESS you provide. 
If an entry presently exists with that address, the current 
definition is displayed. You can then modify or delete that entry. 
An EDIT activity exists that displays the current entries 
sequentially, allowing you to change or delete any of them. To 
examine a listing of the entries without making any changes to them, 
there is a BROWSE activity. The END activity returns you to the 
system profile menu. 

JCL DESCRIPTION: None 
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DIALOG: ADHSICF 

DIALOG NAME: VSE/ICCF Tailoring 
PREREQUISITE DIALOGS: None 
DEFAULT JOB NAME CREATED: ICCFGEN 
OTHER VSE/ICCF MEMBERS CREATED: None 
DIALOG DESCRIPTION: 

This dialog is used to alter the standard defaults of the VSE/ICCF 
system. This is accomplished by changing the operands of the DTSOPTNS 
macro and cataloging it as a new DTSGENER book in USRSL1 (user source 
statement library one) . 

The default values shown are for the CICS/VS version rather than the 
TTF version. If you reply TTF for the system, it will change all of 
the defaults before displaying the remaining panels. If you are using 
TTF, you should run this dialog before running the TTF tailoring 
dialog. (Of course, this is not necessary if you plan on using the 
default ICCF parameters.) 

JCL DESCRIPTION: 

The JCL produced by this dialog performs the following steps: 

• Gives you the option of Fast Copying your user data to tape 
(3310, 3340, and 3330) 

• Restores your service library A from tape to disk 

• Provides online selection of the VSE/ICCF options 

• Catalogs a new DTSGENER book in USRSL1 

• Provides appropriate LIBDEFs for the Stage 2 VSE/ICCF assembly 
and catalog of the affected phases 

• Reassembles and catalogs phases for the VSE/ICCF macros that are 
affected by the options that you changed from their default 
values 

• If you Fast Copyed your user data to tape, provides the option of 
restoring it from tape 
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DIALOG: ADBSIST 

DIALOG NAME: Modify VSE/ICCF Tables 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: PHASETAB or LOADTAB 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in modifying the system file table, 
system program table, and load protection table. In the system file 
table you can modify the space, volume, and file entries. You will 
be able to add, change, delete, and display information in the system 
program table. In the load protection table, you also can add, delete 
and display information. 

JCL DESCRIPTION: 

The JCL generated will catalog to the source statement library 
(0SRSL1) a book (A.DTSSYSPG) to be used in the assembly of DTSCJENT 
and DTSSOBMT. The second step of this job will assemble the new 
phases and put them in the system core image library (IJSTSRS) . 
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DIALOG: ADHfLAB 

DIALOG NAME: Label Information 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: STDLABEL (for system standard labels) 

PARLABEL (for partition labels) 

OTHER VSE/ICCF MEMBERS CREATED: ADM$JCL0 (for standard labels) 

ADM$PARx (for partition labels, 
x is partition number) 

DIALOG DESCRIPTION: 

You will need this dialog when you make changes to DASD files 
delivered with the VSE System IPO/E or when you add or change your 
own DASD files. Files pertaining to libraries are not handled by this 
dialog but by the library information dialog. Summary information for 
several labels is presented, and you may choose the one you wish to 
view by selecting the proper number. When one is selected, a panel 
displaying all the fields of the DLBL statement is presented. 
Existing data may then be changed and blank fields added. You may 
also delete the entire DLBL-EXTENT (s) set by overlaying the FILE NAME 
with DELETE. Select the proper ACTION CODE to view the EXTENT (s) for 
this DLBL or add another DLBL-EXTENT set. You may also add label sets 
at the end of the file by selecting a blank line from the selection 
menu. Select menu item 12 to create the JCL and end your label 
information session. 

Partition labels for background (BG) are supplied with the VSE System 
IPO/E for background work files. Partition labels are also provided 
for foreground partitions F2 and F3. If you wish to create labels for 
other partitions you may do so and the data will be saved 
automatically. 

JCL DESCRIPTION: 

The JCL created will catalog a procedure to the procedure library for 
the system standard labels or the specified partition labels. The 
procedures must be executed to load the labels in the label area. You 
may also load the background labels at IPL time if you tailor the ASI 
procedures after updating standard labels. 
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DIALOG: ADBSLBB 

DIALOG NAME: Library Information 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: NEWLIB 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is the main dialog for library allocation. It calls all of the 
other dialogs that add, delete, update or browse libraries. When the 
called dialog is completed, control is returned to ADM$LBR. 

After you have made all of the changes that you want to your library 
allocations, you must be sure that no overlap exists between 
permanent files. (This refers to files defined by standard or 
partition standard labels.) Neither service libraries nor PUT files 
are checked for overlap, since many of them overlap intentionally* 
Therefore, if you define permanent files on the packs where service 
or PUT files reside, you must be sure that you have not allowed your 
files to overlap. 

If you find overlapping files, you must correct this situation. 
Because overlaps may occur with nonlibrary files, this dialog allows 
you to call the label dialog. Using the label dialog, you can 
relocate the overlapping file, and control will be returned to 
ADM$LBR. 

If no overlap is found, a job stream is created to be submitted in a 
VSE partition. 

For performance reasons, the overlap checking is done only for the 
packs involved in the new library allocations. 

All the modifications you enter for libraries or files are 
permanently filed into the Interactive Productivity Facility profile 
tables. This is true even if you cancel the dialog. 

JCL DESCRIPTION: 

Two VSE jobs are generated and imbedded in one VSE/POWER job* The 
first job backs up the existing libraries which need to be relocated. 
The second job restores these libraries to their new allocations if 
they already existed or creates new libraries if they did not exist. 

Caution: If SYSRES file is relocated, the restore program will be 
copied onto the tape to restore IJSYSRS in stand alone mode. 
Therefore, after the backup job has been run, you must shut down the 
system and IPL the tape. 
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DIALOG: ADHjHSI 

DIALOG NAME: Assemble/Catalog SNT 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SNT$ASN 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

JCL is generated to assemble and catalog the sign-on table. If the 
table does not exist, an error message is displayed. No changes are 
made to any of the table entries. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS SNT 
in the VSE System IPO/E supplied system. If the job should fail, 
first ensure that the CICS/VS macro library and the target core image 
library are available. 
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DIALOG: ADHSHTC 

DIALOG NAME: TTF Tailoring 
PREREQUISITE DIALOGS: (ADM$ICF) 
DEFAULT JOB NAME CREATED: TTFGEN 
OTHER VSE/ICCF MEMBERS CREATED: None 
DIALOG DESCRIPTION: 

This dialog regenerates the TTF system and creates a new startup 
deck. 

You must supply the number of control units that you have, the 
starting SYSnnn number for the terminals, what dump option you want 
used as a default, and whether you want TP balancing. You will then 
be asked for the starting address of the first terminal on each 
control unit, and how many terminals are on each control unit. Next, 
each terminal address will be displayed, and you must identify any 
printers, or if the terminal is to be allowed to use the master 
terminal program. Finally, you must identify the supervisor that you 
are using as a 370 or E mode supervisor. 

JCL DESCRIPTION: 

This dialog is unique in that it has two outputs. The first job 
stream produced will assemble the necessary macros, set up the 
LIBDEFs, and catalog the needed phases. The second job stream will be 
the startup deck that you will use to daily start up your VSE/ICCF 
system. 

Caution: If you intend to tailor your VSE/ICCF system, do it before 
running this dialog, since input from the VSE/ICCF produced tables is 
used. 
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DIALOG: ADESPOT 

DIALOG NAME: POT Library/History Update 

PREREQUISITE DIALOGS: ADM$LBR 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to change the administrative tables to reflect a 
change in the description of a PUT library or history file. The 
current PUT library or history file names will be displayed, and you 
may select the one you wish to change. The dialog will then display 
the current information for this library or file and allow you to 
change the library or- file ID, library or file allocation, directory 
allocation, device type of the pack the library or file is on, volume 
serial number of that pack, or the starting address of the library or 
file. 

| Multiple entries can be selected and updated. When you have 

| completed all the updates you want to make, select END to terminate 

| the dialog. 

JCL DESCRIPTION: None 

DIALOG: ADHSRBP 

DIALOG NAME: Run Security Reports 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SECREP 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in using the report function of 
VSE/Access Control Logging and Reporting. You will be able to 
initialize, dump, restore, select, or reset the data sets of 
VSE/Access Control Logging and Reporting. 

JCL DESCRIPTION: 

The JCL generated is a VSE job stream to perform the selected 
function on the VSE/Access Control Logging and Reporting security 
data sets. 
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DIALOG: ADHSSEC 

DIALOG NAME: Modify Security Table 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SECTAB 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in modifying the security table* You will 
be able to add, change, delete, and display users, groups, libraries, 
files, and phases. 

JCL DESCRIPTION: 

The OCL generated will assemble a new security table (DTSECTAB) and 
put the table in the USRCL1 (user core image library one). 
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DIALOG: ADHSSFM 

DIALOG NAME: Aaa Software Products 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to add, update, or delete entries in your 
software products profile tables, ADM$SHIP and ADM$PROD. These 
entries correspond to products outside the System IPO/E product set. 
They are added to the profile table to allow for the installation and 
servicing of these products using Interactive Productivity Facility 
dialogs. 

You will be asked to supply the following information: 

• Component numbers 

• Component level code 

• If the product is a feature 

• Brief description of product 

• Product number 

• Library set into which product will be installed 

• Release number 

• If the product is installed 

• If the product has VSE/ICCF members 

• Number of files product consists of on distribution tape 

• If the product has a relocatable copy file 

• If the product has a source statement copy file 

• Product core image library size in FBA or library blocks 

• Product relocatable library size in FBA or library blocks 

• Product source statement library size in FBA or library blocks 

Once you have added an entry to the software products system profile 
tables, you can use the create copy files dialog to create copy 
files, if required. Before installing the product using the optional 
product install dialog, you must ensure you have created the 
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designated library large enough to contain that product. The 
Installation Guide is provided to step you through the tasks required 
to install a product outside the product set of the System IPO/E. 
This guide is accessed off the system management menu, SYM$. 

JCL DESCRIPTION: None 

DIALOG: ADHSSFT 

DIALOG NAME: Software Products 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

| OTHER VSE/ICCF MEMBERS CREATED: (DLI$PCT) , (DLI$PPT) , (DLI$ALT) , 
| (DTR$PCT), (DTR$PPT) 

I 

DIALOG DESCRIPTION: 

This dialog is used to maintain a profile of the software products 
installed on your system. Select the software product whose software 
product table entry requires updating. If the product you wish to 
update does not appear on the screen, select the ADDITIONAL PRODUCTS 
entry to continue to page through the existing entries. 

It is possible to install and service products outside the System 
IPO/E product set by adding an entry for that product to the software 
products system profile table. Entries corresponding to such 
products can be added, modified, and deleted using the add software 
products dialog accessed off the system profile menu. After you add 
a product, it will be displayed for selection by this dialog. You 
may then update a limited number of fields. 

A table update is required if a product is removed from the current 
system, the release or identifier number is changed, or the product 

| is to be included or deleted from the CICS/VS tailoring procedure. 

| The tables are updated to show that a product is installed when the 

j install dialog is run. However, this change can be made to the 

| tables directly through this dialog. 

If you indicate the product should be included in the CICS/VS 
tailoring procedure, the necessary system entries for this product 
will be included in the appropriate CICS/VS management tables. The 
VSE/ICCF members listed above contain these entries. Tables that may 
be affected include the processing program table (PPT), the program 
control table (PCT) , and the file control table (FCT) . 

JCL DESCRIPTION: None 
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DIALOG: ADHS0PT 

DIALOG NAME: Update Library 

PREREQUISITE DIALOGS: ADM$LBR 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to change the syster, profile tables to reflect a 
change in the description of a current IBM or user library. The 
current library names will be displayed , and you may select the 
library you wish to change. The dialog will then display the current 
information for this library, and allow you to change the library 
file ID, library allocation, directory allocation, device type of the 
pack the library is on, volume serial number of th£t pack, or the 
starting address of the library. 

This dialog is called by function ADM$LBR and is not accessed from a 
menu panel. 

JCL DESCRIPTION: None 

DIALOG: ADM$USR 

DIALOG NAME: Add VSE/ICCF Users 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: ICCF 

OTHER VSE/ICCF MEMBERS CREATED: ADM$USRT 

DIALOG DESCRIPTION: 

This dialog is used to add users and libraries to the VSE/ICCF 
system. You will be asked to add various VSE/ICCF parameters based 
on the configuration of your system. When you complete the adds for 
as many users as desired, they are filed into table ADM$USRT. Four 
panels are presented to you for the insertion of adds. You should 
consult the VSE/ICC F I nstallation and O peratio ns Reference manual for 
a full explanation of what each parameter means since the explanation 
provided is only a summary of the information in the manual. 

JCL DESCRIPTION: 

The JCL created by this dialog consists of one DTSUTIL job that will 
add as many users as you have entered. In order to run this job you 
must ensure that VSE/ICCF is not running; otherwise, it will not 
enter the adds onto the system. 
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DIALOG: CATSB1C 

DIALOG NAME: Copy Out Catalog 

PREEEQaiSITE DIALOGS: None 

DEFAULT JOB NAME CREATED: BKUPCAT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in backing up either a master catalog or 
user catalog to tape or disk- You will need to know the name of the 
user catalog if that is what you are backing up. You will also be 
asked for information about the backup device. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
back up the desired catalog to tape or disk. 

DIALOG: CATSDEF 

DIALOG NAME: Define Catalog 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DEFCATLG 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in creating either a VSE/VSAM master 
catalog or user catalog. You will be asked which you wish to create 
and then for information on DASD placement and other catalog 
information. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
create the desired catalog. 
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DIALOG: CATSDEL 

DIALOG NAME: Delete Catalog 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DELCATLG 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in deleting a VSE/VSAM user catalog* You 
will be asked the name of the user catalog that you are deleting. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
delete the desired user catalog. 

DIAL06: CATSLST 

DIALOG NAME: List Catalog 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: LIST JOB 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in listing all or selected volumes owned 
by the master catalog or a user catalog. Listing of pointers to all 
the user catalogs in the system can also be done by this dialog. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
list the disk volumes or files owned by the master catalog or a user 
catalog. The job can also be used to list the system pointers. 
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DIALOG: CATSHBS 

DIALOG NAME: Copy in Catalog 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: RESTCAT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in restoring a master catalog or user 
catalog from tape or disk. You will need to know information about 
the restore device. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
restore the desired catalog from tape or disk. 

DIALOG: CAT$TPT 

DIALOG NAME: Transport Catalog 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: TPTUCAT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in exporting or importing a user catalog. 
You will need to know the name of the user catalog, the volume serial 
on which the catalog resides, and the type of DASD. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
export or import a user catalog. 
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DIALOG: CUS$DIA 

DIALOG NAME: Dialog Customization 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CHEATED: CUSVJOB 

OTHER VSE/ICCF MEMBERS CREATED: CUS$PROC 

DIALOG DESCRIPTIONS 

Dialog customization allows you to specify which dialogs you want to 
delete from the Interactive Productivity Facility. You can delete 
tailoring for products you do not have, or functions lor which you 
have no further use such as the first use tutorial. Verification jobs 
that you do not plan to run can also be deleted. The reason for 
deleting dialogs is to save library space and improve performance. 

JCL DESCRIPTION: 

The output of this dialog consists of a VSE job and a VSE/ICCF 
procedure. The VSE job deletes the core image library phases for the 
dialogs to be removed. The VSE/ICCF procedure purges the VSE/ CCF 
members to be deleted. Both must be run to completely remove the 
dialogs selected for deletion. 

| [VH/YSS FEATURE MOTE] In the VM/VSE environment, the output of tfeis 
j dialog is a VM/CMS EXEC. It purges some VM/VSE Feature dialogs. 
| Therefore, it should be used only by userid MAINT. 
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DIALOG: DSFSALT 

DIALOG NAME: Alter Cluster 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: ALTER 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in altering a V,SE/VSAh Olitster. lou can 
alter the file name, accessibility, freespace amounts k retention 
period, and shareoptions. The information needed to alter a cluster 
is: 

• The name of the VSE/VS^M file 

• The type of file (KSDS, ESDS, or RRDS) 

• Whether the file is owned by the master or a user catalog 

• What you want to alter 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
alter a VSE/VSAM cluster. 
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DIALOG: DSPSCOP 

DIALOG NAME: Copy File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: COPY 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in copying a VSE/VSAM or sequential file. 
The sequential file can be on either tape or disk. The copy dialog 
generates job streams to copy a VSE/VSAM file to another VSE/VSAM 
file or to a sequential file. You can also copy a sequential file to 
either a VSE/VSAM or another sequential file. The information that 
you need is: 

Type Of VSE/VSAM file (KSDS, ESDS, or RRDS) 

Starting point of the input file 

Stopping point of the input file 

Output device type 

Starting point of the output device 

Number of tracks (or blocks) in the output file 

Output volume serial 

Output record format 

- Fixed-length records 

- Variable- length unblocked records 

- Variable-length blocked records 

• Output block size 

• Output record size 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
copy a VSE/VSAM or sequential file. 
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DIALOG: DSF$DEF 

DIALOG NAME: Define Cluster 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: FILEDEF 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in defining a VSE/VSAM cluster. You will 
need to know the name and characteristics of the file. You are 
prompted to provide the following information: 

Cluster type (KSDS, ESDS, or RRDS) 

Cluster name 

Volume serial number of the disk where the cluster will be 
located 

Retention date format (JULIAN or DAYS) 

Retention period 

Whether this volume is owned by the master catalog or a user 
catalog 

User catalog name 

Volume serial number of the disk where the user catalog is 
located 

How much space the cluster will occupy 

Primary and secondary ("isk space allocations 

Percentage of control interval free space 

Percentage of control area free space 

Whether the file will be unigue, suballocated, or no allocation 

Whether or not the cluster is reusable 

Average record size 

Maximum record size 

Relative key position within the record 

Key length 
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• Data class 

• Index class 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
define a VSE/VSAM cluster. 

DIALOG: DSFSDBL 

DIALOG NAME: Delete Cluster 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DELETE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in deleting a VSE/VSAM cluster. 

The information needed to delete a cluster is: 

Cluster name 

Whether the cluster should be deleted ever, if its retention 
period has not expired 

Whether information about the cluster is in the master catalog or 
a user catalog 

User catalog name 

Volume serial number of the disk where the user catalog is 
located 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
delete a VSE/VSAM cluster. 
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DIALOG: DSFSDSP 

DIALOG NAME: Display File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DISPLAY 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in displaying a VSE/VSAM data set. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
display a VSE/VSAM data set. 

DIALOG: DSFSEXP 

DIALOG NAME: Export File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: EXPORT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in backing up a VSE/VSAM data set. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
export a VSE/VSAM data set. 
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DIALOG: DSFSIHP 

DIALOG NAME: Import File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: IMPORT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in restoring your VSE/VSAM data sets. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
import a VSE/VSAM data sets. 

DIALOG: DSFSPRT 

DIALOG NAME: Print File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: AMSPRINT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in printing VSE/VSAM or sequential files. 

The print dialogs generate job streams to print VSAM clusters and 
sequential files. You can print each type in either character or 
hexadecimal format, or in both. 

To print a VSAM cluster, you must provide the following information: 

Cluster name 

Volume serial number of the disk where the cluster will be 
located 

Whether information about the cluster is in the master catalog or 
a user catalog 

User catalog name 

Volume serial number of the disk where the user catalog is 
located 

Whether you want to print selected records 
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• How you want to specify print start and stop 

• Start and stop keys 

• Number of records to be skipped 

Sequential files may be on tape or disk. If you are printing a 
sequential file, some of the the following information will be 
needed: 

• The device the file is on 

• Volume serial number 

• File name 

• For tape files: 

- Whether the tape is labelled or unlabelled 

- Whether you want label checking 

- Rewind options 

- Tape address 
Record format 
Block size 
Record size 

Whether you want to print selected records 
How you want to specify print start and stop 
Number of records to be skipped 
Record count 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
print your VSE/VSAM or sequential data sets. 
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DIALOG: DSF$VER 

DIALOG NAME: Verify File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: VERIFY 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in displaying system information about 
your VSE/VSAM data sets. 

The information needed to verify a cluster is: 

Cluster name 

Volume serial number of the disk where the cluster is located 

Whether information about the cluster is in the master catalog or 
a user catalog 

User catalog name 

Volume serial number of the disk where the user catalog is 
located 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
display system information about your VSE/VSAM data sets. The verify 
cluster dialogs generate job streams to check if a VSE/VSAM cluster 
was closed properly the last time it was used. If it was not closed 
correctly, the verify function will update the catalog to allow the 
cluster to be used again. 
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DIALOG: BHVSDEP 

DIALOG NAME: Select Environment Definition 

PREREQUISITE DIALOGS: ENV$DEF 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog allows selection of an environment from table ENV$DEFT* 
Table ENV$DEFT is created by dialog ENV$DEF in the update environment 
definition subf unction. This table contains the environment name, 
associated menu name, and comments about the environment. 

An environment is simply a collection of menus and functions that 
perform a given task. System management is an example of an 
environment. The initial entry to the selected environment is via a 
menu panel. 

JCL DESCRIPTION: None 
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DIALOG: E1VSDEF 

DIALOG NAME: Update Environment Definition 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCP MEMBERS CREATED: ENV$DEFT 

DIALOG DESCRIPTION: 

This dialog is used to add, alter, or delete environment definitions. 
An environment is a collection of menus and functions used to perform 
a given task. The following items are saved in table ENV$DEFT for 
the select environment definition subfunction: 

• Environment name: Twenty-four characters concatenated together. 
Separate each word with a dash. Pad the end with dashes to 24 
characters. Otherwise, panel ENV$DEF1 will not line up properly. 

• Menu name: This is the name of the menu used to enter the 
environment. This panel will appear when the environment is 
chosen in the select environment definition subfunction. 

• Comment: Four eight-character fields that are not concatenated 
that may be used as comments about the environment. 

Table ENV$DEFT contains the information described above for all the 
environments you have defined. If you wish to centrally maintain 
ENV$DEFT, you should give copies of it to each user. This table must 
reside in the use^s primary library or in the library in which the 
ENV$ tables reside according to the connect table in DTR$DTBL. 

Vote: When you add a new environment, you should add the VSE/ICCF 
libraries for the environment to the Interactive Productivity 
Facility connect table. See the section •Interactive Productivity 
Facility User Options File 1 in the Interactiv e Productivity Facility 
VSE F eature User' s Guide and the same section in this manual for 
further information. 

JCL DESCRIPTION: None 
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DIALOG: IHSfCAH 

DIALOG NAME: Installation 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: INSTALL 

| OTHER VSE/ICCF MEMBERS CREATED: (DLI$PCT) , (DLI$PPT) , (DLI$ALT) 

DIALOG DESCRIPTION: 

This dialog is used to install products on your system. You can 
install one or multiple products by library. 

This dialog displays several groups of products for installation as 
follows: 

• Products you flagged during the first time use dialog as products 
you would eventually install on your system 

• Products supported by the System IPO/E that were flagged for 
installation using the software products update function 

• Products not supported by the System IPO/E that were added to the 
software products system profile table using the add software 
products dialog 

When these products are displayed, they are grouped by library. 

Indicate which of these products you want to install at this time by 
supplying the tape file and volume numbers corresponding to these 
products. The tape file number specifies the file number 
corresponding to the first file of the product found on the 
distribution tape. If the tape is stacked (contains more than one 
product), this value is obtained from the label on the distribution 
tape. If the tape is nonstacked, enter the value 1. The install 
dialog supports the installation of products obtained from more than 
one tape volume. In order to communicate to you which tape volume 
must be mounted during execution of the install function, a unique 
volume number must be assigned to each tape. Number the first tape 
one (1), and assign sequentially increasing numbers to each of the 
others. 

After selecting which products corresponding to a particular library 
you wish to install at this time, and being asked about possible 
support under CICS/VS of those products to which it applies, you will 
be queried about the status of that library's service libraries. 
With the exception of service libraries A, B, and E, (if CICS/VS is 
installed) which are shipped with the System IPO/E base install 
process, JCL to create a particular service library is generated the 
first time the optional product install dialog is run to install a 
product in that library. Successive runs of the dialog will ask 
whether you want to reproduce that JCL (and possibly recreate the 
service library), whether you want to restore an existing service 
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library, and whether you want to back up that service library. These 
steps are repeated for as many libraries as you indicated would have 
products installed in them. 

If you have selected all the products you plan to install at this 
time, you can bypass the display of products residing in additional 
libraries by entering END in the TAPE FILE field of the first product 
displayed corresponding to a library in which you have no products to 
install. This will cause the dialog to complete processing without 
the display of any additional products. 

JC1 DESCRIPTION: 

The JCL created by the optional product install dialog contains the 
following set of jobs for each library in which you have requested 
products to be installed at this time. Jobs to create/restore the 
current service library set as described in the dialog description 
above are included first. Next, a set of six possible jobs are 
included for each product to be installed in this library. An MSHP 
RESTORE DTAPE job is provided to restore the product libraries and 
history file from the product distribution tape to temporary restore 
areas. A DSERV of the restored product libraries is then performed. 
A job is included optionally, depending on whether the product has 
VSE/ICCF members that must be copied to the VSE/ICCF DTSFILE. If it 
does, as in the case of DL/1 DOS/VS, a DTSUTIL job is created and the 
VSE/ICCF members stored as I. books in the product source statement 
library are punched from the temporary restore area to the internal 
reader. This job is executed later, after VSE/ICCF has been brought 
down, copying the members into the VSE/ICCF DTSFILE. 

[VH/VSE FEATURE MOTE] If VSE/ICCF is not installed in the VM/VSE 
environment, the I. books are not punched to the internal reader. 

The I. books are then deleted from the restore area. An MSHP INSTALL 
COMPONENT FROMDISK MERGE job is executed to merge the restored 
libraries into the production core image library, and the service 
relocatable and source statement libraries. A job is included to 
modify the retention period of the MSHP restore area created above. 
They are given a zero retention period, which causes them to become 
expired files. This eliminates the need to respond delete when 
installing multiple products. A job is then included to perform an 
MSHP RETRACE COMPONENT against the product just installed. 

To complete the processing of this library, jobs are included to 
delete all the relocatable modules from the production relocatable 
library, and copy from the service relocatable library modules 
corresponding to all those products that have been installed in this 
library to date that are required for day-to-day production use. 
Similar jobs are included for the source statement production and 
service libraries. 

With mixed architecture, if the temporary restore areas and the 
current library's production libraries are on a split of FBA and CKD 
devices, the JCL produced will differ from that described above. A 
private core image library is created, and the MSHP INSTALL COMPONENT 
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FROMDISK MERGE job mentioned above will merge the core image library 
phases into this library. After all products to be installed in this 
library have been restored and merged, this newly created library is 
backed up to tape, and restored either directly to the production 
core image library, or to another newly created core image library 
and merged into the production core image library. Next, a private 
relocatable library is created and the relocatable production members 
are merged in. This library is backed up to tape and restored into 
the production relocatable library. The same procedure is followed 
for the source statement library. 

After all the libraries have been processed as described above, a job 
to reestablish the system LIBDEFs is executed. If for any reason, 
the install job stream does not run to completion, you must perform 
the following steps to reestablish your system LIBDEFs. Release the 
PAUSEBG job from the system reader. Issue ASSGN SISCLB,UA and // 
EXEC PROC=LIBDEF before responding to end the job. 

If you have selected ACF/VTAM or ACF/VTAHE for installation, a job 
will be included to copy the RAS transients from production core 
image library C to production core image library A. 
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DIALOG: LIBSCIT 

DIALOG NAME: Catalog Library Members 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: CATALOG 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog allows you to generate JCL statements to catalog members 
to any system or private library. Modules saved in the VSE/ICCF 
library may be specified to be included. 

This dialog requests the following information: 

• Library type (core image, relocatable, source, or procedure) 

• Whether the library is system or private 

• The catalog member name (phase, module, book, or procedure) 

• The ICCF member name 

• If a source library, the sublibrary desired 

• If private, the file name, volume serial number, and file ID 

• If a core image library: 

- Whether more relocatable or ICCF members are to be included 
in the link-edit 

- Whether a LIBDEF statement should be generated for 
relocatable libraries and the names for the LIBDEF statement 

- Whether DLBL and EXTENT (s) should be generated 

— File name 

— Volume serial 

— File ID 

JCL DESCRIPTION: 

The JCL created will link-edit to core image libraries or execute 
MAINT to catalog to relocatable, source, or procedure libraries. 
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DIALOG: LIBSCOP 

DIALOG NAME: Copy Library Members 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: COPY 

OTHER YSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog allows you to copy any system or private library or part 
of any library. 

The information needed to copy or merge between libraries is: 

• Library type (core image, relocatable, source, or procedure) 

• Whether the TO library is residence, nonresidence, or private 

• Whether the FROM library is residence, nonresidence, or private 

• Volume serial number 

• File name for the FROM and TO library 

• Volume serial number of the FROM and TO library 

• File ID of the FROM and TO library 

• Member (s) to be copied 

JCL DESCRIPTION: 

The JCL created consists of an execution of CORGZ and associated 
parameters. 
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DIALOG: LIBSCRT 

DIALOG NAME: Create Libraries 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: CREATE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog allows you to create libraries. 

You are prompted to provide the following information: 

Library type (core image, relocatable, source, or procedure) 

DASD type 

Start location 

Library size 

Directory size 

File name 

Serial number 

Retention date 

File ID 

JCL DESCRIPTION: 

The JCL created consists of an execution of CORGZ and associated 
parameters. 
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DIALOG: LIB$DBL 

DIALOG NAME: Delete Library Members 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DELETE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog allows you to DELETE library members from any system or 
private library. 

This dialog requests the following: 

• Library type (core image, relocatable, source, or procedure) 

• Whether the library is system or private 

• If private, the file name, volume serial number, and file ID 

• The member (s) to be deleted 

JCL DESCRIPTION: 

The JCL created consists of an execution of MAINT and associated 
parameters. 
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DIALOG: LIBSDSP 

DIALOG NAME: Display Library Members 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DISPLAY 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog allows you to DISPLAY or PUNCH library members from any 
system or private library or to display the directories of any 
library. 

The display directory dialog requests the following information: 

• Whether the library is a system or private library 

• Library type (core image, relocatable, source, procedure) or 
directory type (transient or second level) 

• Whether a sorted or nonsorted listing is desired 

• If a private library, the file name, volume serial, and file ID 

JCL DESCRIPTION: 

The JCL created consists of an execution of DSERV, CSERV, RSERV, 
PSERV, SSERV, or ESERV parameters. 
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DIALOG: LIBSRBH 

DIALOG NAME: Rename Library Members 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: RENAME 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog allows you to RENAME library members in any system or 
private library. 

This dialog requests the following: 

• Library type (core image, relocatable, source, or procedure) 

• Whether the library is system or private 

• If private, the file name, volume serial number, and file ID 

• The OLD and NEW library member (s) 

JCL DESCRIPTION: 

The JCL created consists of an execution of MAINT and associated 
parameters. 
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DIALOG: OPHSJCI 

DIALOG NAME: JCL Creation 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: JCL 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This activity helps you create the job control statements required to 
run jobs under VSE or in a VSE/ICCF interactive partition. The 
output from jobs that execute in a VSE/ICCF interactive partition is 
directed to disk files or the terminal. Input comes from disk files, 
the terminal, or the job stream itself. The output for jobs that 
execute in a VSE batch partition is directed to the system printer 
(or to the terminal if you submit it with the return option). Other 
I/O devices may include disk f tape, or diskette. 

JCL DESCRIPTION: 

This dialog will produce a job stream to execute a compiler, utility, 
or application program. 
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DIALOG: PDVSEXP 

DIALOG NAME: Program Development 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

The program development environment provides explain panels on the 
following topics: 

Program development 

Library structure 

Create/modify 

RPG II create/modify 

Compi le/assemble 

Input/output 

Load/execute 

Submit to batch 

JCL DESCRIPTION: None 
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DIALOG: BPTSOHP 

DIALOG NAME: Dump Analysis. 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: IPCS 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in creating either a VSE job stream to 
execute the Migrate program, or a VSE job stream to execute the IPCS 
program. 

JCL DESCRIPTION: 

The JCL generated is either to list the identification of all dumps 
contained in the VSE system dump files, or to format a specified dump 
printout. 

DIALOG: SPCSDEF 

DIALOG NAME: Define Space 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SPACEDEF 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in defining space for VSE/VSAM. You will 
be asked which catalog (master or user) will own the space, 
information on DASD placement, and size of the space. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
define the VSE/VSAM space in the catalog. 
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DIALOG: SPCSDEL 

DIALOG NAME: Delete Space 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SPACEDEL 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in deleting VSE/VSAM space from a master 
or user catalog. You will be asked which catalog owns the space that 
you are deleting. 

JCL DESCRIPTION: 

The JCL generated is a VSE/VSAM Access Method Services utility to 
delete VSE/VSAM space from the catalog. 

DIALOG: SRVSAAP 

DIALOG NAME: Archive APAR Fix 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: ARCHIVE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog creates the JCL to archive an APAR fix into your system 
history file. You will be asked for the APAR number and affected 
macros, modules, and phases. 

JCL DESCRIPTION: 

The JCL invokes MSHP passing control statements built from your 
input. 
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DIALOG: SRVSAPT 

DIALOG NAME: Archive PTF 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: ARCHIVE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog creates the JCL to archive a program temporary fix (PTF) 
into your system history file- You will be asked for the PTF number, 
APAR number, prerequisite, corequisite, and negative prerequisite PTF 
numbers, affected macros, modules, and phases, link-edit information, 
and the space required to apply the fix in the respective libraries, 

JCL DESCRIPTION: 

The JCL invokes MSHP passing control statements built from your 
input. 

DIALOG: SRYSBAC 

DIALOG NAME: Backup History File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: BACKUP 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog creates the JCL to invoke the backup history file feature 
of MSHP. It will copy your existing history file, defined by your 
standard labels, to tape. 

JCL DESCRIPTION: 

The JCL invokes MSHP passing control statements built from your 
input. 
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DIALOG: SHVSCM 

DIALOG NAME: JCL Comments 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog turns an internal switch on or off to indicate if 
optional comments are desired. Normally, enough comments are in the 
JCL to properly run the service dialogs. However* if you have a 
problem or would like additional information about the JCL, using 
this option will insert additional comments in the JCL. 

Caution: Creating the additional comments will prolong the actual 
running of the dialog. 

JCL DESCRIPTION: None 

DIALOG: SRYSCOH 

DIALOG NAME: Condense History 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: CONDENSE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog creates the JCL to invoke the remove obsolete feature of 
MSHP. This is used to remove entries that have been flagged as 
obsolete by the installation of a later release level. During normal 
installation and the application of service, it is not necessary to 
run this dialog. 

JCL DESCRIPTION: 

The JCL invokes MSHP passing control statements built from your 
input. 
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DIALOG: SRV$CVL 

DIALOG NAME: Print Cover Letters 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: Print 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog creates the JCL to print cover letters from a tape. You 
will need to supply the file number for the file that contains the 
cover letters. You will have the option of printing them 
continuously, or one to a page. You may print all of the cover 
letters or just selected ones. 

JCL DESCRIPTION: 

JCL is produced for invoking MSHP to print the cover letters. 

DIALOG: SRVSFIX 

DIALOG NAME: Alter Core Image 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SRV 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is a common dialog called by the alter relocatable, and alter 
source dialogs. It will invoke MSHP and apply a ZAP directly to the 
core image library. It will also record the information in the system 
history file. You will need to know the phase names that are to be 
altered, the data that is at the location you wish to change, and if 
the phase needs to be expanded. 

JCL DESCRIPTION: 

A single job is produced. It invokes MSHP and passes it control 
statements generated from your input. 
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DIALOG: SBVSFIX 

DIALOG NAME: Alter Relocatable 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SRV 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is a common dialog called by the alter core image, and alter 
source dialogs. It will invoke MSHP and apply a REP directly to the 
relocatable library. It will also record the information in the 
system history file. You will need to know the module names that are 
to be altered, the data that is at the location you wish to change, 
if the module needs to be expanded, and the name of the link book 
used to link edit the fix into the core image library (if necessary) . 

JCL DESCRIPTION: 

A single job is produced. It invokes MSHP and passes it control 
statements generated from your input. 

DIALOG: SRVSFIX 

DIALOG NAME: Alter Source 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SRV 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is a common dialog called by the alter core image, and alter 
relocatable dialogs. It will invoke MSHP and apply a single statement 
update directly to the source statement library. It will also record 
the information in the system history file. You will need to know the 
book names that are to be altered, the data used to verify that you 
are at the correct location (E. books only) , and the sublibrary that 
the books are in. If you choose the revokable option, a deck will be 
punched which can be used to remove the alteration should the need 
arise. If you need to use the deck, it will be necessary to edit it 
and insert the JCL for directing it to the proper service libraries. 

JCL DESCRIPTION: 

A single job is produced. It invokes MSHP and passes it control 
statements generated from your input. 
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DIALOG: SRYSGEN 

DIALOG NAME: Post Assemblies 
PREREQUISITE DIALOGS: SRV$PRE, SRV$FIX 
DEFAULT JOB NAME CREATED: Variable 
OTHER VSE/ICCF MEMBERS CREATED: None 
DIALOG DESCRIPTION: 

This dialog is used to perform assemblies of CICS/VS management 
modules, CICS/VS A. macros, and VSE/ICCF modules. It is accessed from 
menu panel SRV$523. This menu is not in the normal menu hierarchy, 
but is called at the completion of the SRV$FIX dialog, if either 
CICS/VS or VSE/ICCF were serviced. However, if you have run the 
preservice dialog, you could go directly to the menu panel for this 
dialog by typing =SHV$523. 

The three functions of this dialog are: 

1. Support of the DFHGEN macro for CICS/VS to allow you to 
reassemble management modules 

2. Assembly of serviced A. macros into E. macros and cataloging them 
into service library B 

3. Support of the DTSSG macro for VSE/ICCF to allow you to 
reassemble the ICCF modules 

JCL DESCRIPTION: 

The JCL produced by this dialog will establish necessary to and from 
LIBDEF statements for the stage 1 and stage 2 of either VSE/ICCF or 
CICS/VS. It will then produce the necessary assembly statements and 
route the output into the VSE/POWER internal reader (DISP=I) . It then 
produces JCL for OBJMAINT that places cleanup JCL into the VSE/POWER 
internal reader. 
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DIALOG: SRVSPOS 

DIALOG NAI-1E: Post Service 

PREREQUISITE DIALOGS: (SRV$CMN) 

DEFAULT JOB NAME CREATED: POSTSRV 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used for restoring your system to normal after using 
the SRV$PRE and SRV$FIX dialogs. Based on the component you 
identified during the execution of the SRV$PRE dialog, the members in 
the service libraries that are copied into the production libraries 
are merged into the proper production libraries. You will have the 
option of backing up the service libraries to tape, .and, if the pack 
was copied to tape, you will be asked if you would like it restored 
from tape. 

JCL DESCRIPTION: 

JCL is produced for the merge to the production libraries, providing 
that there are production library members for the component. JCL is 
optionally produced for fast copy, and backup of the service 
libraries. At the conclusion of this dialog, your normal LIBDEF 
library chain for the production libraries will be restored. 
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DIALOG: SH?$PRB 

DIALOG NAME: Preservice 

PREREQUISITE DIALOGS: (SRV$CMN) 

DEFAULT JOB NAME CREATED: PRESRV 

OTHER VSE/ICCF MEMBERS CREATED: (SRV$FCDT) 

DIALOG DESCRIPTION: 

This dialog is used to prepare for applying an APAR/LOCAL fix to 
either the relocatable or source statement libraries. It gives you 
the option of Past Copying your user disks to tape before restoring 
the service libraries. You will need to know the address of the tape 
drive that can be used and the component identifier of the component 
for which you have the fix. Based on the component identifier, the 
dialog lets you restore the correct service library. You will also be 
allowed to restore an additional service library, and it will be 
concatenated to the first. However, do not make any changes to the 
second library since it will not be backed up to tape. 

JCL DESCRIPTION: 

JCL is optionally produced for fast copy, initialize disk, and 
restore of the service libraries. At the end of the JCL, the service 
libraries that you restored, or mounted, will be concatenated to your 
production library chain for searches. 
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DIALOG: SRV$PTF 

DIALOG NAME: Apply PTF 

PREREQUISITE DIALOGS: (SRV$CMN) 

DEFAULT JOB NAME CREATED: PTF 

OTHER VSE/ICCF MEMBERS CREATED: (SRV$FCDT) 

DIALOG DESCRIPTION: 

This dialog creates the JCL to apply a program temporary fix (PTF). 
The PTF to be applied must be on a corrective service file on the PUT 
tape. 

The dialog will request the following information: 

• The component ID of the product to which you are going to apply 
service 

• Whether you wish to create backout PTFs 

• Whether your service libraries are on disk or tape 

• Whether you will restore your service libraries from tape, do you 
want to fast copy user data to tape 

• Whether you want a backup of your production libraries before 
service 

• Whether you wish to produce a dialog flow diagram describing the 
creation and manipulation of files and data with the produced JCL 

JCL DESCRIPTION: 

If all options are taken the JCL produced will: 

Back up your production libraries via the backup program. 

Fast Copy your user data on the packs that will be used to tape. 
(This is for device types of 3310, 3330, and 3340 only.) 

Initialize the volumes that were backed up to tape. 

Create a private system library (PUTNRS) and then delete any 
members copied by the create. 

Create a work history file (SAVEHST) and establish residence for 
the product to which you are going to apply service. 

Establish ownership for the product in the system history file. 

Create a set of private libraries that will be the target for 
selecting the PTF from the PUT tape (PUTCL1, PUTRL1, and PUTSL1). 
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Select the PTF from the corrective service files on the PUT tape 
and apply it to the libraries that the MSHP preprocessor creates. 

Merge the PTF from the files built by the last step into the 
private libraries created above (PUTCL1, PUTRL1, and PUTSL1). 

Restore the service library from tape. 

Perform the MSHP upgrade to the PUTNRS area and the service 
libraries. 

Merge from the production library into the PUTNRS library all of 
the members that were not affected by service. 

Delete all of the members in the production core image library. 

Copy everything in PUTNRS to the production core image library. 

If the component you are applying a PTF for has members in either 
the production relocatable or source statement library, they will 
be updated at this point as in the apply PUT dialog. 

User exit before backup of the service library. 

Back up the service library to tape. 

If any volumes were copied to tape, they will be restored at this 
time. 

The permanent LIBDEF chain is restored. 
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DIALOG: SRV$PT? 

DIALOG NAME: Apply Cumulative PTF 

PREREQUISITE DIALOGS: (SRV$CMN) 

DEFAULT JOB NAME CREATED: PTF 

OTHER VSE/ICCF MEMBERS CREATED: (SRV$FCDT) 

DIALOG DESCRIPTION: 

This dialog creates the JCL to apply a program temporary fix (PTF). 
The PTF to be applied must be on a cumulative PTF tape. 

The dialog will reguest the following information: 

• The component ID of the product to which you are going to apply 
service 

• Whether you wish to create backout PTFs 

• Whether your service libraries are on disk or tape 

• Whether you will restore your service libraries from tape, do you 
want to fast copy user data to tape 

• Whether you want a backup of your production libraries before 
service 

•Whether you wish to produce a dialog flow diagram describing the 
creation and manipulation of files and data with the produced JCL 

JCL DESCRIPTION: 

The following description is for a product that resides in production 
library A. Therefore, it is in the system core image library. 

If all options are taken the JCL produced will: 

Back up your production libraries via the backup program. 

Fast Copy your user data on the packs that will be used to tape. 
(This is for device types of 3310, 3330, and 3340 only.) 

Initialize the volumes that were backed up to tape. 

Create a private system library (PUTNRS) , and then delete any 
members copied by the create. 

Create a work history file (SAVEHST), and establish residence for 
the product to which you are going to apply service. 

Establish ownership for the product in the system history file. 



80 Interactive Productivity Facility Reference 



Create a set of private libraries that will be the target for 
selecting the PTF from the PUT tape (PUTCL1, PUTRL1, ana P0TSL1). 

Select the PTF from the cumulative PTF file, and apply it to the 
libraries created above. 

Restore the service library from tape. 

Perform the MSHP upgrade to the PUTNRS area and the service 
library. 

Copy everything in PUTNRS to the production core image library. 

If the component for which you are applying a PTF has members in 
either the production relocatable or source statement library, 
they will be updated at this point as in the apply PUT dialog. 

User exit before backup of the service library. 

Back up the service library to tape. 

If any volumes were copied to tape, they will be restored at this 
time. 

The permanent LIBDEF chain is restored. 
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DIALOG: SBVSPTF 

DIALOG NAME: Apply Backout PTF 

PREREQUISITE DIALOGS: (SRV$CMN) 

DEFAULT JOB NAME CREATED: PTF 

OTHER VSE/ICCF MEMBERS CREATED: (SRVfcFCDT) 

DIALOG DESCRIPTION: 

This dialog creates the JCL to apply a backout PTF to your system. It 
is used to remove a PTF that is found to be in error after it has 
been installed on your system. 

The dialog will reguest the following information: 

• The component ID of the product 

• Whether your service libraries are on disk or tape 

• Whether you will restore your service libraries from tape, do you 
want to fast copy user data to tape 

• Whether you want a backup of your production libraries before 
service 

• Whether you wish to produce a dialog flow diagram describing the 
creation and manipulation of files and data with the produced JCL 

JCL DESCRIPTION: 

If all options are taken the JCL produced will: 

Back up your production libraries via the backup program. 

Fast copy your user dara on the packs that will be used to tape. 
(This is for device types of 3310, 3330, and 3340 only.) 

Initialize the volumes that were backed up to tape. 

Create a private system (PUTNRS) , and then delete any members 
copied by the create. 

Establish ownership for the product in the system history file. 

Copy the system history file to the save history file (SAVEHST) . 

Restore the proper service library from tape. 

Select the PTF from the backout PTF files. 

Merge from the production library into the PUTNRS library all of 
the members that were not affected by service. 
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Delete all of the members in the production core image library. 

Copy everything in PUTNRS to the production core image library. 

If the component for which you are applying a PTF has members in 
either the production relocatable or source statement library, 
they will be updated at this point as in the .apply PUT dialog. 

User exit before backup of the service library. 

Back up the service library to tape. 

If any volumes were copied to tape, they will be restored at this 
time. 

The permanent LIBDEF chain is restored. 
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DIALOG: SRVSPOT 

DIALOG NAME: Apply POT 

PREREQUISITE DIALOGS: (SRV$CMN) 

DEFAULT JOB NAME CREATED: PUT 

OTHER VSE/ICCF MEMBERS CREATED: SRV$LIB, (SRV$FCDT) 

DIALOG DESCRIPTION: 

This is a common dialog and is called by the restart PUT and apply 
selective dialogs. Just the apply PUT is being described here. This 
dialog creates the JCL to apply a program update tape (PUT). 

The dialog will reguest the following information: 

What service libraries will be serviced (identified by product 
contents) 

What products you wish to exclude from service 

What PTFs you wish to reject 

Whether you wish to create backout PTFs 

Whether your service libraries are on disk or tape , 

If you will restore your service libraries from tape, do you want 
to Fast Copy user data to tape 

Whether you want a backup of your production libraries before 
service 

Whether you wish to produce a dialog flow diagram describing the 
creation and manipulation of files and data with the produced 
JCL. 

JCL DESCRIPTION: 

If all options are taken the JCL produced will: 

• Back up your production libraries via the backup program. 

• Fast Copy your user data on the packs that will be used to tape. 
(This is for device types of 3310, 3330, and 3340 only.) 

• Initialize the volumes that were backed up to tape. 

| • Execute the MSHP preprocessor to restore the PUT libraries from 
| tape to the PUTxL2 areas and then merge them into the PUTxLl 
| areas. The history file (PUTHST1) is created during the execution 
j of this job. 
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• Move the PUTRL1 relocatable library to its normal area. 

From this point on, we will loop through the service libraries 
applying service. We will explain library A first since it is a bit 
different due to the system core image library. 

• Restore service library A from tape using the allocations found 
in the system profile tables. 

• Create a system new residence file on another disk using the 
allocations for PUTNRS. 

• Clear out all of the entries in this library. This is done to 
eliminate all of the $$ phases that were merged during the 
allocation. 

• Copy the PUT history file (PUTHST1) to the PUT save history file 
(SAVEHST) . Upgrades will be done from the save history file as 
the upgrade manipulates the from history file. 

f 

| • Copy your system history file (SYSHST) to the work history file 
| (HRKHST) . This is done to ensure integrity of your system history 
t file in case the PUT job stream abnormally terminates for some 
\ reason. 

• Remove all of the components that are in the other service 
libraries from the PUT save history file^. This is to eliminate 
multiple processing of the same PTFs by MS HP, and printing a lot 
of error messages that really are not errors. 

• Establish library ownership for the work libraries and the 
service libraries using the MSHP residence statement. 

• Upgrade the service libraries and the new system residence file. 
If you selected the backout PTF option, the backout PTFs are 
punched to tape at this time. 

• Compile the supervisors that are found in the system profile 
tables. These supervisors will be cataloged into the new system 
residence file. 

• Copy all phases that have not been changed from your system 
residence library to the new system residence file. 

• Merge the procedure library into the new system residence file. 

• Delete all modules in the production relocatable library for 
library A. This will make room for recreating this library with 
all of the newly serviced members. It also eliminates the 
possible need for a condense. 

• Merge all of the production members from service relocatable 
library A into the production library. 
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• Repeat the same steps for the production source statement 
library. 

[¥H/¥SB FEATURE HOTS] The following step is not performed in the 
VM/VSE environment if VSE/ICCF is not installed, 

• Punch any I. books from the service library A source statement 
library to tape. This will be members for the VSE/ICCF DTSFILE. 

• Remove any I. books from the service library A source statement 
library. 

[YH/VSE FEATURE BOTE] The following step is not performed in the 
VM/VSE environment if VSE/ICCF is not installed. 

• Execute the DTSOTIL program reading the input from the tape we 
just created. This will catalog the VSE/ICCF members into the 
DTSFILE* Ignore any error messages on SYSLST for the CATALS and 
BKEND statements. 

• Pause on user exit. This allows you to perform any additional 
steps you wish on service library A before backing it up to tape. 
Of course you will have to do it from another partition. 

• Back up service library A to tape. 

• Back up the new system residence file to tape. You will later I PL 
this tape and restore it over your old system residence file. 

• Copy the work history file (WORKHST) to the system history file 

(SYSHST). 

For the rest of the service libraries the steps are the same with the 
exception of service library B. Service library B contains CICS and 
is rather large* Therefore, it is done last f and requires a second 
and third invocation of the MSHP preprocessor. The following 
describes libraries C - G. 

• Restore the service library from tape. 

• Accessing the system residence file that was created before as a 
private core image library (WORKCL) delete all of the entries in 
the library. 

• Copy the PUT history file (PUTHST1) to the save history file 
(SAVEHST) . 

• Copy your system history file (SYSHST) to the work history file 

(WRKHST). This is done to ensure integrity of your system history 
file in case the PUT job stream abnormally terminates for some 
reason. 

• Remove all of the components that are in the other service 
libraries from the PUT save history file. 
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Establish library ownership for the work libraries and the 
service libraries using the MSHP residence statement. 

Upgrade the service libraries and the private core image library 
(WORKCL) . If you selected the backout PTF option, the backout 
PTFs are punched to tape at this time- 
Copy all phases that have not been changed from your production 
core image library to the new private library (WORKCL) . 

Delete all of the members in the production core image library. 
This sets the pointers back to zero and eliminates the need for a 
condense. 

Copy all of the members from the private core image library 
(WORKCL) to the now empty production core image library. 

Delete all modules in the production relocatable library. 

Merge all of the production members from the service relocatable 
library into the production library. 

Repeat the same steps for tne production source statement 
library. 

[YH/VSE FEATURE NOTE] The following step is not performed in the 
VM/VSE environment if VSE/ICCF is not installed. 

If there are any products in the library that could have service 
for members in the VSE/ICCF DTSFILE, punch any I. books from the 
service library source statement library to tape. This will be 
members for the VSE/ICCF DTSFILE* 

If there are any products in the library that could have service 
for members in the VSE/ICCF DTSFILE, remove any I. books from the 
service library source statement library. 

[VM/YSE FEATURE HOTS] The following step is not performed in the 
VM/VSE environment if VSE/ICCF is not installed. 

If you executed the above steps, execute the DTSUTIL program 
reading the input from the tape we just created. This will 
catalog the VSE/ICCF members into the DTSFILE. Ignore any error 
messages on SYSLST for the CATALS and BKEND statements. 

Pause on user exit. This allows you to perform any additional 
steps you wish on service the service library before backing it 
up to tape. Of course, you will have to do it from another 
partition 

Back up the service library to tape. 

Copy the work history file (WORKHST) to the system history file 
(SYSHST) . 
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The above steps will be repeated for each service library with the 
exception of library B f which contains CICS* The steps for servicing 
library B are explained under the explanation for the restart PUT 
dialog. 

• If any volumes were copied to tape they will be restored at this 
time. 

• Retrace the system history file. 

• The permanent LIBDEF chain is restored. 

At this point, it is necessary to IPL the standalone tape that was 
created. This will replace your existing system residence file* 
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DIAL06: SRYSPOT 

DIALOG NAME: Restart POT 

PREREQUISITE DIALOGS: SRV$PUT, (SRV$CMN) 

DEFAULT JOB NAME CREATED: PUT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is a common dialog and is called by the apply PUT and apply 
selective dialogs. Just the restart PUT is being described here. This 
dialog creates the JCL to restart the application of a PUT from a 
successful checkpoint. Tou will need to know the last checkpoint that 
was successfully passed. Tou will also need to re-enter all 
information originally supplied to the apply PUT dialogs after the 
checkpoint. See the apply PUT dialog description for the information 
required. 

Correct execution of this dialog depends upon information passed from 
the apply PUT dialog. 

JCL DESCRIPTION: 

Correct execution of this JCL requires that the files generated 
during the execution of the apply PUT JCL are intact. 

The following description is for service library B,. It was run on a 
system that had all service libraries and was restarted at checkpoint 
6. 

• Execute the MSHP preprocessor including all of the products that 
are in library B. 

• Move the relocatable library to its normal position (PUTRL1) . 

• Restore service library B. 

• Create a private core image library that will be used as a target 
during the upgrade step. 

• Delete anything in the library that was copied as a result of the 
previous allocate step. 

• Copy the PUT history file (PUTHST1) to the PUT save history file 
(SAVEHST). 

• Copy your system history file (SYSHST) to the work history file 
(WRKHST) . This is done to ensure the integrity of your system 
history file in case the PUT job stream abnormally terminates for 
some reason. 
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Remove all of the entries in the save history file (SAVEHST) that 
are not for products that are in service library B. 

Establish residence for the products in service library B. 

Upgrade the private core image library (WORKCL) and service 
library B. 

Copy all of the phases from the original production library B 
that have not been affected by the application of service. 

Delete all of the members in production core image library B. 

Copy all members from the work core image library (WORKCL) into 
the production core image library B. 

Delete all modules in the production relocatable library. 

Merge all of the production members from the service relocatable 
library into the production library. 

Repeat the same steps for the production source statement 
library. 

Pause on user exit. This allows you to perform any additional 
steps you wish on service library B before backing it up to tape. 
Of course, you will have to do it from another partition. 

Back up updated service library to tape. 

Copy the work history file (WORKHST) to the system history file 
(SYSHST) . 

The above steps are then repeated for service library E. Service 
library E contains CICS/VS Tertiary and Macro libraries. Another 
execution of the MSHP preprocessor is required because of library 
size constraints. There are no core image or relocatable 
libraries in service library set E. Therefore, some steps will be 
omitted. The following steps are then executed. 

If any volumes were copied to tape they will be restored at this 
time. 

Retrace the system history file. 

The permanent LIBDEF chain is restored. 
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DIALOG: SRV$PUT 

DIALOG NAME: Apply Selective PUT 

PREREQUISITE DIALOGS: (SRV$CMN) 

DEFAULT JOB NAME CREATED: PUT 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is a common dialog and is called by the apply PUT and restart 
PUT dialogs. Just the apply selective PUT is being described here. 
This dialog creates the JCL to apply one or more selected products 
from the PUT tape. You will need to know the three-digit component 
level code (CLC) . This information is available with the 
machine-readable PUT documentation on the PUT tape. You will also 
need to input the standard PUT information/ (should the service 
library be restored etc.) . 

JCL DESCRIPTION: 

The following description is for application of the PUT files to 
service library B. It describes the JCL produced for a mixed 
architecture environment. In this particular case, DOSRES, SYSWK1, 
and SYSWK4 were 3310s, and SYSWK2 and SYSWK3 were 3340 device types. 

If all options are taken the JCL produced will: 

• Back up your production libraries via the backup program. 

• Fast copy your user data on the packs that will be used to tape. 

• Initialize the volumes that were backed up to tape. 

• Execute the MSHP preprocessor to restore the PUT libraries from 
tape to the PUTxL2 areas and then merge them into the PUTxLI 
areas. The history file (PUTHST1) is created during the execution 
of this job. 

Move the PUTRL1 relocatable library to its normal area. 

Restore service library B from tape. 

Create private core image library (PUTNRS) 

Copy the PUT history file (PUTHIST1) to the save history file 
(SAVEHST) . 

Copy your system history file (SYSHST) to the work history file 
(WORKHST) . This is done to insure integrity of your system 
history file in case the PUT job stream abnormally terminates. 
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Remove all of the entries in the save history file (SAVEHST) for 
components in other service libraries- 
Establish residence in work history file (WORKHST) for the 
products in service library B* 

MSHP upgrade with target of private core image library (POTNRS) 
and service library B. 

Back up the private core image library to tape (POTNRS) . 

Restore the library to SYSWK1 as a private core image library 
(SYSNRS). 

Copy all of the members from production library B (PRDCLB) that 
were not affected by service to the private core image library 
(SYSNRS) . 

Delete all of the members in production library B (PRDCLB). 

Copy all of the original and serviced phases from the private 
work library (SYSNRS) to production core image library B 
(PRDCLB) . 

Create a private relocatable library on SYSWK3 (WORKRL) 
overlaying the PUTNRS area. 

Copy all of the relocatable modules that reside in production 
relocatable library B (PRDRLB) from service relocatable library B 
(SRVRLB) . This includes any modules that were serviced. 

Back up the work library (WORKRL) to tape. 

Restore this tape over the top of production relocatable library 
B (PRDRLB). 

Repeat the above four steps for the source statement library. 

Pause for a user exit on service library B. 

Back up and retain service library B to tape. 

Copy the work history file (WORKftST) to the system history file 
(SYSHST) . 

Fast copy from tape the user data for SYSWK2 and SYSWK3. 

Retrace the system history file (SYSHST) . 

Restore the permanent LIBDEF search chain. 
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DIAL06: SBVSBBH 

DIALOG NAME: Remove History Record 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: REMOVE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog creates the JCL to invoke the remove feature of MSHP. You 
may use it for removing the history file entry for an APAR/LOCAL fix 
or for a PTF entry. 

Vote: This dialog onxy removes the entry from the history file. The 
actual code for the APAR/LOCAL fix or PTF is still on your system. 

JCL DESCRIPTION: 

The JCL invokes MSHP passing control statements built from your 
input, 

DIAL06: SBVSBET 

DIALOG NAME: Retrace History 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: RETRACE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCKIPTION: 

This dialog creates the JCL to invoke the retrace feature of MSHP. 
There are several options of what information to print. Details of 
what will be printed for each option are provided on the explain 
panels. 

JCL DESCRIPTION: 

The JCL invokes MSHP passing control statements built from your 
input. 
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DIALOG: SBVSBHS 

DIALOG NAME: Restore History File 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: RESTORE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog creates the JCL to invoke the restore history file 
feature of MSHP* It will copy your existing history file, defined by 
your standard labels, from tape to disk. 

JCL DESCRIPTION: 

The JCL invokes MSHP passing control statements built from your 
input. 

DIALOG: SRVSOHD 

DIALOG NAME: Undo Core Image 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: UNDO 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is a common dialog called by the undo relocatable dialog as 
well. It will invoke MSHP to remove a ZAP that was applied to the 
core image library. It will also remove the information from the 
system history file. It is necessary that the fix have been applied 
with the revokable option in order to use this function. 

JCL DESCRIPTION: 

A single job is produced. It invokes MSHP and uses the information 
stored in the system history file. 
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DIALOG: SRVSUID 

DIALOG NAME: Undo Relocatable 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: UNDO 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This is a common dialog called by the undo core image dialog as well, 
It will invoke MSHP to remove a REP that was applied to the core 
image library. It will also remove the information from the system 
history file, and, if the fix was link-edited into the core image 
library, it will cause a new link-edit to remove the fix from the 
core image library. It is necessary that the fix have been applied 
with the revokable option in order to use this function. 

JCL DESCRIPTION: 

A single job is produced. It invokes MSHP and uses the information 
stored in the system history file. 



| £VM/¥SE FEATURE BOTE] In the VM/VSE environment, the following 

I thirteen dialogs (from SYI$1 through SYI$13) are named with prefixes 

| beginning with VMT$ instead of SYI$. 

DIALOG: SYIS1 

DIALOG NAME: Introduction 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

Brief overview of both the first use tutorial and the Interactive 
Productivity Facility. 

JCL DESCRIPTION: None 
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DIALOG: SYIS2 

DIALOG NAME: Adjusting Screen 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

How to adjust the brightness and contrast. 

JCL DESCRIPTION: None 

DIALOG: SYIS3 

DIALOG NAME: Exiting 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

How to exit from the Interactive Productivity Facility and return to 
the underlying system (CMS for VM or ICCF for VSE) . 

JCL DESCRIPTION: None 

DIALOG: SYI$1 

DIALOG NAME: Cursor Movement 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

How to use the arrow and tab keys to position the cursor to a desired 
location on the screen. 

JCL DESCRIPTION: None 
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DIALOG: STIS5 

DIALOG NAME: Indicators 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

Describes the meaning and use of the input inhibited, system 
available, and insert mode indicators for the 3277 and similaf 
indicators for the 3278. 

JCL DESCRIPTION: None 

DIALOG: STIS6 

DIALOG NAME: Management/Use 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

4 DIALOG DESCRIPTION: 

Describes these two basic areas of system activity and shows 
examples. 

JCL DESCRIPTION: None 

DIALOG: SYIS7 

DIALOG NAME: Menu Panel 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

Describes the use of the menu panel in dialogs and what the service 
line of options will do for you when selected. 

JCL DESCRIPTION: None 



Section 2 - Dialog Descriptions 97 



DIALOG: SYIS8 

DIALOG NAME: Data Entry Panel 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

Describes the use of the data entry panel in dialogs and wkat the 
service line of options will do for you when selected. 

JCL DESCRIPTION: None 

DIALOG: SYI$9 

DIALOG NAME: Explain Panel 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

Describes the use of the explain panel in dialogs and what the 
service line of options will do for you when selected. The OVERVIEW 
option is also explained and examples shown. 

JCL DESCRIPTION: None 

DIALOG: SYIS10 

DIALOG NAME: Insert/Delete 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

How to use the INS MODE, DEL, and ERASE keys. 

JCL DESCRIPTION: None 
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DIALOG: SYIS11 

DIALOG NAME: Other Keys 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

How to use the CLEAR, program function (PF) , and APL ON/OFF keys. 

JCL DESCRIPTION: None 

DIALOG: SYIS12 

DIALOG NAME: Light-pen 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

How to use the light-pen in responding to panels that contain 
detectable fields. 

JCL DESCRIPTION: None 

DIALOG: SYIS13 

DIALOG NAME: Fast Path 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: None 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

How to use the =panelname command to move quickly to any menu. 

JCL DESCRIPTION: None 
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DIALOG: TASfHAS 

DIALOG NAME: ASI Procedure Tailoring 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: ASIPROC 

OTHER VSE/ICCF MEMBERS CREATED: TAS$SDWK, (TAS$SD11 - 40) 

DIALOG DESCRIPTION: 

This dialog is used to prepare automated system initialization (ASI) 
procedures to make it easy to start up your system. You will choose 
one or all of the fifteen ASI procedures during the first use dialog. 
You may also migrate ASI tables from prior releases. The ASI 
procedure (s) chosen will be used by this dialog as a prototype for 
building your own ASI procedure. Even if you will not make any 
changes to the prototype, you should still execute this dialog as 

| several commands needed at initial install will be deleted here. 

| Also, new standard labels on libraries reguire a new ASI procedure to 

j be generated. 

JCL DESCRIPTION: 

The JCL created by this dialog consists of one IPL procedure and 
several JCL procedures that will be cataloged to the procedure 
library. If a procedure by the same name is already in the library, 
| it will be renamed to save it. The old IPL procedure will be renamed 
| $IPLSAV. The old JCL procedures will be renamed $XJCLSAV, where X is 
I the partition ID. After the JCL is submitted to VSE/POWER, the 
| procedure cataloged, and you have verified that there were no errors, 
you should perform another initial program load (IPL) . The IPL will 
also set up USRSL1 as the source library that VSE/POWER will use for 
source library inclusion (SLI) . Some verification job streams reguire 
SLI for proper execution. 
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DIALOG: TCISAFC 

DIALOG NAME: CICS Tailoring: Ada Data Set 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: FCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$FCnn, (where nn is the suffix 

of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, the table is opened. If the table does not 
exist, a new table is initialized. You are then asked to enter the 
name of the file, its type, and allowable modes of access. If the 
file is a DL/I file, only the name and type are used. If the file 
already exists in the table, the old entry will not be overlaid. When 
all the descriptive information has been entered a test is made for 
the presence of segmented records or an indirect access data set. If 
an indirect access data set is specified, you are prompted for 
indirect access specifications. No test is made for the presence of 
the specified object data set. If segmented records are specified, 
you are prompted to enter segment specifications until the last 
segment has been described. Indirect access and segmented records 
are mutually exclusive specifications. When all the information about 
the data set has been entered, you are given the opportunity to enter 
another data set or end the function, when the last entry has been 
made, entries for the FCT are generated. JCL is generated to 
assemble and catalog the table. Entries required for installed 
optional products are picked up automatically. There are nc required 
FCT entries for CICS or ICCF. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS FCT 
in the System IPO/E supplied system. If the job should fail, fir,st 
ensure that the CICS macro library and the target core image library 
are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the LSI procedure has set up 
a permanent search to point to a source statement libLaiy containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up u search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISAPC 

DIALOG NAME: CICS Tailoring: Add Transaction 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: PCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$PCnn (where nn is the 

suffix of Ihe taMo) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If m table with the specified 
suffix already exists, the table is opened. If the table does not 
exist a new table is initialized. You are then asked to enter the 
name of the transaction, its associated program, and how it will be 
used. If the transaction already exists in the table, the old entry 
will not be overlaid. When the last entry has been Lade * entries for 
the PCT are generated. JCL is generated to assemble <i.nfi catalog the 
table. Entries required for CICS, ICCF, ana other installed optional 
products are picked up automatically. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble an 3 catalog a CICS PCT 
in the System IPO/E supplied system. If the joe should fail, first 
ensure that the CICS macro library and the target core image library 
are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containxng 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCI$APP 

DIALOG NAME: CICS Tailoring: Add Program 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: PPT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$PPnn, (where nn is the 

suffix of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table wit J the specified 
suffix already exists, the table is opened. Tf the table doefs not 
exist a new table is initialized. You are then asked to enter the 
name of the program, the language, and the freguency of use. 7f the 
program already exists in the table, the old entry will not b<*. 
overlaid. When the last entry has been made, entries for both the P'PT 
and ALT are generated except when the program usage is low. In that 
case, no ALT entry is generated. JCL is generated to assemble and 
catalog the table. Entries reguired for CICS, ICCF, and other 
installed optional products are picked up automatically. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS PPT 
and ALT in the VSE System IPO/E supplied system. If the job should 
fail, first ensure that the CICS macro library and the target core 
image library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISATC 

DIALOG NAME: Add Terminal 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: TCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$FEAT, TCI$FTnn, TCI$LUnn, 

TCI$RMnn, TCI$SDnn, TCI$TCnn, 
TCI$TRnn (where nn is the suffix 
of the table) 

DIALOG DESCRIPTION: 

This dialog will allow you to create and add terminals to your 
terminal control table (TCT) . You will need to know the 
characteristics of your terminals and lines before tailoring the TCT. 

The terminals you will be adding to your TCT may be attached to a 
BTAM network only. 

You will be asked to supply a suffix for this TCT which will be be 
reflected in the VSE/ICCF members, as well as the phase name of the 
TCT which will be cataloged into the core image library. This suffix 
is not related to the preassembled TCTs as supplied in the CICS/VS 
core image library. 

The type of terminals which may be added to your TCT using this 
tailoring dialog are 3211, 3216, 3278, 3284, 3286, 3287, 3288, and 
3289. 

The type of remote line to which the- above terminals may be attached 
is a binary synchronous transmission line (BISYNC) with the 
transmission in extended binary coded decimal interchange code 
(EBCDIC) . The line connection must be dedicated (nonswitched) . For 
local attachment, the above terminals may attach to a 3272, 3274, or 
3276. The access method used is the Basic Telecommunications Access 
Method (BTAM-ES). 

You will add terminals to the TCT according to the line to which they 
will be attached. For example, if you have five terminals to be 
attached to a local control unit, and six terminals to be attached to 
a remote line, you will add all the terminals associated with either 
the local control unit or the remote line and then add the other 
group of terminals. 

You will be asked for a DATA SET CONTROL NAME to be associated with 
each group of terminals. This name must be unigue for each group of 
terminals. You may enter this dialog at a later date and add 
terminals to an existing group in which case you would need to know 
the data set control name you had provided* To assist you with the 
selection of a data set control name, the names that have already 
been defined for your system are displayed. VTAM is a reserved word 
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and may not be used as the data set control name for a group of 
terminals. 

You will be asked the type of line for the group of terminals being 
added. Your response will be either LOCAL or REMOTE. If the response 
is remote , you will be asked to provide the PROGRAMMER LOGICAL UNIT 
to be assigned to the line. This is in the format of SYSNNN where NNN 
is a number that will appear in the // ASSGN SYSNNN card of the 
CICS/VS startup job stream. You will also be asked to provide a 
relative control unit number for each remote control unit on each 
line. This dialog allows you to add 32 terminals to each remote 
control unit and allows you to have four control units for each 
remote line. Each local control unit may also have 32 terminals. 

At this point, the dialog will ask you for specific information about 
each terminal to be added to the terminal group. 

The dialog will ask you for a unique four-character identification 
for each terminal. The previously used terminal IDs will be displayed 
for you at this time. 

The dialog will then ask you for the type and model of terminal to be 
added to the TCT. Valid terminal types are 3276, 3277, 3278, 3284, 
3286, 3287, 3288, or 3289. The valid models are either 1 or 2, except 
for the 3276 and 3278, which may also be model 3 or 4, and the 3288 
which may only be a model 2. Note that model 3 or 4 will be generated 
in the created job stream as a model 2. 

If you are adding to a local line group, the dialog will ask for the 
programmer logical unit that will be assigned to this terminal. 

You are now asked for the features that are on the terminal you are 
adding. For the display terminals (32 77, 3276, or 3278) , the features 
that are possible are selector pen, audible alarm, copy, typewriter 
and/or operator console keyboard, translate lowercase to uppercase, 
APL text, APL keyboard, and text keyboard. For the printer terminals 
(3284, 3286, 3287, 3288, or 3288), the features are copy, print, and 
text print. 

After entering all your responses correctly for the first terminal, 
you will have the chance to enter the same information for each 
additional terminal you wish to add to the same line group. 

When finished with adding all the terminals for one terminal group, 
you may continue to add a second terminal group with its associated 
terminals. 

You will have the option of specifying an existing VSE/ICCF member to 
be inserted into the generated TCT assembly. This inserted VSE/ICCF 
member would include TCT entries that are in addition to the entries 
you have entered via the dialog. 

After adding all your terminals, the dialog will give you a choice of 
canceling all changes, updating the table without assembling, or 
updating the table and assembling the new TCT. 
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If at any point you type or probe CANCEL on the command line, none of 
the responses will be saved. 

JCL DESCRIPTION: 

The JCL created by this dialog will assemble and catalog a TCT to the 
user's core image library with a phase name of DFHTCT (suffix) . The 
TCT entries for this assembly will be generated using the supplied 
information from the dialog. To test the new TCT you must reassemble 
the currently used DFHSIT table with TCT=nn # where nn is the suffix 
supplied in the dialog or have a DFHSIT override of TCT=nn. 

If you have selected to insert an VSE/ICCF member within the TCT 
assemble, you may have assembly errors. The entries included in this 
manner are included in the table as is. They are not checked by the 
dialog for validity. Since the individual entries in this file cannot 
be examined, the dialog cannot check that any further entry you make 
via the dialog is not in conflict with an entry defined in the 
VSE/ICCF member you included. Also, the delete and modify dialogs 
cannot update entries in your included file. You will get the full 
benefit of the table preparation dialogs only if you use the dialogs 
exclusively to add entries to your table. 

All CICS/VS tables are link-edited into user core image library 1 
(USECL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B 
which contains the necessary macros. 
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DIALOG: TCISCFC 

DIALOG NAME: CIGS Tailoring: Change Data Set 

PREREQUISITE DIALOGS: TCI$AFC 

DEFAULT JOB NAME CREATED: FCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$FCnn, (where nn is the 

suffix of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, the table is opened. If the table does not 
exist an error message is displayed. You are asked for the name of 
the file specification to be changed. If the file does not exist in 
the table, an error message is displayed. If the file already exists 
in the table, you are then asked to enter the name of the file, its 
type, and allowable modes of access. If the file is a DL/I file, 
only the name and type are used. If the name of the file is changed, 
a new entry with that name will be created. The old entry is not 
overlaid. All other changes affect the file entry selected. When all 
the descriptive information has been entered, a test is made for the 
presence of segmented records or an indirect access data set. If an 
indirect access data set is specified, you are prompted for indirect 
access specifications. No test is made for the presence of the 
specified object data set. If segmented records are specified, you 
are prompted to enter segment specifications. When the last segment 
of the current specification has been displayed you are given the 
opportunity to enter additional segment specifications. 

Vote: Indirect access and segmented records are mutually exclusive 
specifications. When all the information about the data set has been 
entered you are given the opportunity to change another data set or 
end the function. When the last entry has been made, entries for the 
FCT are generated. JCL is generated to assemble and catalog the 
table. Entries required for installed optional products are picked 
up automatically. There are no required FCT entries for CICS or 
ICCF. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS FCT 
in the System IPO/E supplied system. If the job should fail, first 
ensure that the CICS macro library and the target core image library 
are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISCPC 

DIALOG NAME: CICS Tailoring: Change Transaction 

PREREQUISITE DIALOGS: TCI$APC 

DEFAULT JOB NAME CREATED: PCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$PCnn (where nn is the 

suffix of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, the table is opened. If the table does not 
exist, an error message is displayed. You are then asked to enter 
the name of the transaction. If the transaction already exists in the 
table, the old entry will be displayed, and you may then modify the 
parameters. When the last change has been made, entries for the PPT 
are generated. JCL is generated to assemble and catalog the table. 
Entries required for CICS, ICCF, and other installed optional 
products are picked up automatically. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS PCT 
in the VSE System IPO/E supplied system. If the job should fail, 
first ensure that the CICS macro library and the target core image 
library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1). The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B 
which contains the necessary macros. 
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DIALOG: TCISCPP 

DIALOG NAME: CICS Tailoring: Change Program 

PREREQUISITE DIALOGS: TCI$APP 

DEFAULT JOB NAME CREATED: PPT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$PPnn, (where nn is the 

suffix of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, the table is opened. If the table does not 
exist, an error message is displayed. You are then asked to enter 
the name of the program. If the program already exists in the table, 
the old entry will be displayed, and you may then modify the 
parameters. When the last change has been made, entries for both the 
PPT and ALT are generated except when the program usage is low. In 
that case, no ALT entry is generated. JCL is generated to assemble 
and catalog the table. Entries required for CICS, ICCF, and other 
installed optional products are picked up automatically. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS PPT 
and ALT in the VSE System IPO/E supplied system. If the job should 
fail, first ensure that the CICS macro library and the target core 
image library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISCTC 

DIALOG NAME: Change Terminal 

PREREQUISITE DIALOGS: TCI$ATC 

DEFAULT JOB NAME CREATED: TCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$FEAT, TCI$FTnn, TCI$LUnn, 

TCI$RMnn, TCI$SDnn, TCI$TCnn, 

TCI$TRnn (where nn is the suffix 
of the table) 

DIALOG DESCRIPTION: 

This dialog will allow you to change the characteristics of your 
terminals that have been added to your terminal control table (TCT) . 

You will be asked to supply the suffix for the TCT that contains the 
terminals you want to change. This suffix is the same suffix you 
supplied when you added to the TCT and is not related to the 
preassembled TCTs as supplied in the CICS/VS core image library. 

The dialog will ask you for the unique four-character identification 
of the terminal you want to change. The terminal IDs used when the 
terminals were added will be displayed* 

The dialog will then display the terminal type and terminal model as 
it was supplied when the terminal was added and give you a chance to 
change either the £ype or model. Valid terminal types are 3276, 3277, 
3278, 3284, 3286, 3287, 3288, or 3289. The valid models are either 1 
or 2, except for the 3276 and 3278, which may also be model 3 or 4, 
and the 3288, which aiay only be a model 2. Note that model 3 or 4 
will be generated in the created job stream as a model 2. 

The dialog will then display the features for this terminal and allow 
them to be changed. For the display terminals (3277, 3276, or 3278), 
the features that are possible are selector pen, audible alarm, copy, 
typewriter and/or operator console keyboard , translate lowercase to 
uppercase, APL text, APL keyboard, and text keyboard. For the printer 
terminals (3284, 3286, 3287, 3288, or 3288), the features are copy, 
print, and text print. 

If the terminal you are changing is attached to a local control unit, 
the dialog will display the associated programmer logical unit and 
allow a different programmer logical unit to be entered. 

After making all necessary changes to the first terminal, you will 
have the chance to enter the same information for each additional 
terminal you wish to change. 

As with adding to the TCT, you have the option of specifying an 
existing VSE/ICCF member to be inserted into the generated TCT 
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assembly. This inserted VSE/ICCF member would include TCT entries 
that are in addition to the entries you have changed via the dialog. 

After changing all your terminals, the dialog will give you a choice 
of cancelling all changes, updating the table without assembling, or 
updating the table and assembling the new TCT. 

If at any point you type or probe CANCEL on the command line, none of 
the responses will be saved. 

JCL DESCRIPTION: 

The JCL created by this dialog will assemble and catalog a TCT to the 
users core image library with a phase name of DFHTCT (suffix) . The TCT 
entries for this assembly will be generated using the supplied 
information from the dialog. To test the new TCT, you must reassemble 
the currently used DFHSIT table with TCT=nn where nn is the suffice 
supplied in the dialog, or have a DFHSIT override of TCT=nn. 

If you have selected to insert an VSE/ICCF member within the TCT 
assemble, you may have assembly errors. The entries included in this 
manner are included in the table as is. They are not checked by the 
dialog for validity. Since the individual entries in this file cannot 
be examined, the dialog cannot check that any further entry you make 
via the dialog is not in conflict with an entry defined in the 
VSE/ICCF member you included. 

All CICS/VS tables are link- edited into user core image library 1 
(USRCL1) • The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISDPC 

DIALOG NAME: CICS Tailoring: Delete Data Set 

PREREQUISITE DIALOGS: TCI$AFC 

DEFAULT JOB NAME CREATED: FCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$FCnn, (where nn is the 

suffix of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, the table is opened. If the table does not 
exist, an error message is displayed. You are then asked to enter 
the name of the file If the file specification already exists in the 
table, the old entry will be deleted. If the transaction does not 
exist, an error message is displayed. When the last deletion has been 
made, entries for the FCT are generated. JCL is generated to 
assemble and catalog the table. Entries required for CICS, ICCF, and 
other installed optional products are picked up automatically. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS PCT 
in the VSE System IPO/E supplied system. If the job should fail, 
first ensure that the CICS macro library and the target core image 
library ate available. 

All CICS/TS tables are link-edited into user core image library 1 
(DSRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISOPC 

DIALOG NAME: CICS Tailoring: Delete Transaction 

PREREQUISITE DIALOGS: TCI$APC 

DEFAULT JOB NAME CREATED: PCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$PCnn (where nn is the 

suffix of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, the table is opened. If the table does not 
exist, an error message is displayed. You are then asked to enter 
the name of the transaction. If the transaction already exists in the 
table, the old entry will be deleted. If the transaction does not 
exist, an error message is displayed. When the last deletion has been 
made, entries for the PCT are generated. JCL is generated to 
assemble and catalog the table. Entries required for CICS, ICCF, and 
other installed optional products are picked up automatically. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS PCT 
in the VSE System IPO/E supplied system. If the job should fail, 
first ensure that the CICS macro library and the target core image 
library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISDPP 

DIALOG NAME: CICS Tailoring: Delete Program 

PREREQUISITE DIALOGS: TCI$APP 

DEFAULT JOB NAME CREATED: PPT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$PPnn, (where nn is the 

suffix of the table) 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, the table is opened. If the table does not 
exist, an error message is displayed- You are then asked to enter 
the name of the program. If the program already exists in the table, 
the old entry will be deleted. If the program does not exist, an 
error message is displayed. When the last deletion has been made, 
entries for both the PPT and ALT are generated except when the 
program usage is low. In that case, no ALT entry is generated. JCL is 
generated to assemble and catalog the table. Entries reguired for 
CICS, ICCF, and other installed optional products are picked up 
automatically. 

JCL DESCRIPTION: 

The generated JCL is that reguired to assemble and catalog a CICS PPT 
and ALT in the VSE System IPO/E supplied system. If the job should 
fail, first ensure that the CICS macro library and the target core 
image library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCIfDTC 

DIALOG NAME: Delete Terminal 

PREREQUISITE DIALOGS: TCI$ATC 

DEFAULT JOB NAME CREATED: TCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: TCI$FEAT # TCI$FTnn, TCI$LUnn, 

TCI$RMnn, TCI$sdnn, TCI$TCnn, 

TCI$TRnn (where nn is the suffix 
of the table) 

DIALOG DESCRIPTION: 

This dialog will allow you to delete terminals from your terminal 
control table (TCT) . 

You will be asked to supply the suffix of the TCT from which you want 
to delete the terminals. This suffix is the same suffix you supplied 
when you added to the TCT and is not related to the preassembled TCTs 
as supplied in the CICS/VS core image library. 

The dialog gives you a choice of deleting an entire group of 
terminals or one terminal at a time. 

If you select to delete an entire group of terminals, the dialog will 
ask you to supply the data set control name for the group to be 
deleted. This is the same name you used when the terminals were 
added, and the dialog will display all the data set control names 
used for this TCT. 

To delete an individual terminal you will need to know the terminal 
ID you supplied when the terminal was added to the TCT. Again the 
dialog will display all the terminal IDs used. You may delete more 
than one terminal if you select to delete one terminal at a time. 

As with adding to the TCT, you have the option of specifying an 
existing VSE/ICCF member to be inserted into the generated TCT 
assembly! This inserted VSE/ICCF member would include TCT entries 
that are in addition to the entries you have not deleted via the 
dialog. 

After deleting all your terminals, the dialog will give you a choice 
of cancelling all changes, updating the table without assembling, or 
updating the table and assembling the new TCT. 

If at any point you type or probe CANCEL on the command line, none of 
the responses will be saved. 

JCL DESCRIPTION: 

The JCL created by this dialog will assemble and catalog a TCT to the 
users core image library with a phase name of DFHTCT (suffix) . The TCT 
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entries for this assembly will be generated using the supplied 
information from the dialog. To test the new TCT, you must reassemble 
the currently used DFHSIT table with TCT=nn, where nn is the suffix 
supplied in the dialog or have a DFHSIT override of TCT=nn. 

If you have selected to insert an VSE/ICCF member within the TCT 
assemble, you may have assembly errors. The entries included in this 
manner are included in the table as is. They are not checked by the 
dialog for validity. Since the individual entries in this file cannot 
be examined, the dialog cannot check that any further entry you make 
via the dialog is not in conflict with ?n entry defined in the 
VSE/ICCF member you included. 

All CiCS/VS tables are link-edited into user core image library 1 
(0SRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 

DIALOG: TCISHFC 

DIALOG NAME: CICS Tailoring: Assemble/Catalog File Table 

PREREQUISITE DIALOGS: TCI$AFC 

DEFAULT JOB NAME CREATED: FCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, JCL is generated to assemble and catalog the 
table. Entries required for installed optional products are picked 
up automatically. If the table does not exist, an error message is 
displayed. No changes are made to any of the table entries. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS FCT 
in the VSE System IPO/E supplied system. If the job should fail, 
first ensure that the CICS macro library and the target core image 
library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCISHPC 

DIALOG NAME: CICS Tailoring: Assemble/Catalog Transaction Table 

PREREQUISITE DIALOGS: TCI$APC 

DEFAULT JOB NAME CHEATED: PCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

You are asked for the table suffix. If a table with the specified 
suffix already exists, JCL is generated to assemble and catalog the 
table. Entries required for CICS, ICCF, and other installed optional 
products are picked up automatically. If the table does not exist, an 
error message is displayed. No changes are made to any of the table 
entries. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS PCT 
in the VSE System IPO/E supplied system. If the job should fail, 
first ensure that the CICS macro library and the target core image 
library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USECL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TCI$HPP 

DIALOG NAME: CICS Tailoring: Assemble/Catalog Program Table 

PREREQUISITE DIALOGS: TCI$APP 

DEFAULT JOB NAME CREATED: PPT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

You are asked for the table suffix- If a table with the specified 
suffix already exists, JCL is generated to assemble and catalog the 
table. Entries required for CICS, ICCF, and other installed optional 
products are picked up automatically. If the table does not exist , an 
error message is displayed. No changes are made to any of the table 
entries. 

JCL DESCRIPTION: 

The generated JCL is that required to assemble and catalog a CICS PPT 
and ALT in the System IPO/E supplied system. If the job should fail, 
first ensure that the CICS macro library and the target core image 
library are available. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1). The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B r 
which contains the necessary macros. 
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DIALOG: TCISHTC 

DIALOG NAME: Assemble/Catalog Terminal 

PREREQUISITE DIALOGS: TCI$ATC 

DEFAULT JOB NAME CREATED: TCT$ASnn (where nn is the suffix of the 

table) 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will allow you to assemble and catalog a previously 
tailored terminal control table (TCT) . 

You will be asked to supply the suffix of the TCT you want to 
assemble and catalog. This suffix is the same suffix you supplied 
when you added to the TCT and is not related to the preassembled TCTs 
as supplied in the CICS/VS core image library. 

As with adding to the TCT, you have the option of specifying an 
existing VSE/ICCF member to be inserted into the generated TCT 
assembly. This inserted VSE/ICCF member would include TCT entries 
that are in addition to the entries you have added, deleted, or 
changed via the dialogs. 

JCL DESCRIPTION: 

The JCL created by this dialog will assemble and catalog a TCT to the 
users core image library with a phase name of DFHTCT (suffix) . The TCT 
entries for this assembly will be generated using the supplied 
information from the previous TCT tailoring dialogs. To test the new 
TCT, you must reassemble the currently used DFHSIT table with TCT=nn, 
where nn is the suffix supplied in the dialog or have a DFHSIT 
override of TCT=nn. 

If you have selected to insert an VSE/ICCF member within the TCT 
assemble, you may have assembly errors. The entries included in this 
manner are included in the table as is. They are not checked by the 
dialog for validity. 

All CICS/VS tables are link-edited into user core image library 1 
(USRCL1) . The assembly JCL assumes that the ASI procedure has set up 
a permanent search to point to a source statement library containing 
CICS/VS macros. In the System IPO/E system, the standard ASI 
procedure sets up a search for production source statement library B, 
which contains the necessary macros. 
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DIALOG: TBP$ASH 

DIALOG NAME: EP/VS 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: EPIPF 

EPSTG1 
EPSTG2 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in building the job streams necessary to 
generate an EP/VS control program. You will be asked for information 
about your 370X and the lines attached to it. 

JCL DESCRIPTION: 

The EP/VS dialog builds three job streams. The first job stream, with 
a default name of EPIPF, catalogs the EP/VS generation macros (which 
are created based on your responses to the EP/VS panels) to user 
source statement library USRSL1. You should run the EP verify job 
and read its output before you use the output from this dialog. 

The second job stream, with a default name of EPSTG1, submits the 
EP/VS generation macros to stage one of the EP/VS generation 
procedure. Stage one of the generation procedure produces an object 
module and an assembler listing. This job stream will catalog the 
object module to a user relocatable library. Check the assembler 
listing for error messages. If there are any errors, you must 
correct them before continuing with the generation procedure. 

The third job stream, with a default name of EPSTG2, submits EP/VS to 
stage two of the EP/VS generation procedure. In the third job 
stream, you will find some include statements. Make sure that these 
include statements match the ones in your assembler listing from 
stage 1 of the generation procedure. If the statements do not match, 
change the third job stream to match your assembler listing. 

In stage two of the generation procedure, the object module that was 
created and cataloged in stage one of the generation procedure is 
link-edited to produce a load module. Then this load module is moved 
from the core image library to a file where the EP/VS loader will be 
able to find it. At the end of the third job stream you will find 
the statements needed to move this module from the core image 
library. Finish the dlbl and extent statements by assigning them to 
two available cylinders from a disk pack. 

When you kave finished generating EP/VS, you will need to load EP/VS 
in your 370X controller. See the EP/VS Generation and Utilities 
Manual (SC3 0-3 116) for further information on loading EP/VS. 
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DIALOG: TPW$ASH 

DIALOG NAME: VSE/POWER Tailoring 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DTRPOWER 

OTHER VSE/ICCF MEMBERS CREATED: TPW$ASMT, TPW$ASME, TPW$ASMF 
(temporary) 

DIALOG DESCRIPTION: 

This dialog is used to change certain VSE/POWER parameters from their 
current or initial values. 

JCL DESCRIPTION: 

The JCL created will: 

• Back up work pack, if required 

• Restore service library A, if required 

• Assemble new VSE/POWER phase and catalog it in user core image 
library 1 

• Restore work pack, if required 
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DIALOG: TRJSASH 

DIALOG NAME: VSE/POWEF RJE Tailoring 

PREREQUISITE DIALOGS: TPW$ASM 

DEFAULT JOB NAME CREATED: TRJxxxx (where xxxx is generated 

from the system definition name provided 
by you during VSE/POWER RJE tailoring) 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

The system supplied VSE/POWER RJE and user defined specifications c*»n 
be displayed for use in creating new specifications, should you need 
multiple RJE systems. 

To facilitate creating an updating of a VSE/POWER RJE system, the 
Interactive Productivity Facility tailoring dialogs supports the 
following subsets of parameters: 

BSC line definitions 

SNA terminal definitions 

BSC terminal definitions 

3780 definition 

2770, 2780 definition 

You may select a saved set of specifications, and edit only the 
parameters reguiring change. 

The VSE/POWER RJE dialogs provide the following functions: 

• Create a completely new VSE/POWER RJE definition 

• Update an existing VSE/POWER RJE definition 

• Add additional lines and terminals to your present RJE system 

• Modify an existing entry in your present RJE system 

• Delete an existing entry from your present RJE system 

• Delete a complete RJE system definition 

Panel TRJ$ASM1 is the key to using the VSE/POWER RJE dialogs. It 
specifies what RJE definition is to be used as the default for this 
iteration, and what the name of the new definition (SAVE NAME) will 
be. If the DEFAULT NAME is different from the SAVE NAME and the SAVE 
NAME is not blank, the create function will be executed. If the SAVE 
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NAME is the same as the DEFAULT NAME, or the SAVE NAME is blank, the 
update function will be executed- At no time are you allowed to 
create a definition with the same name as the VSE/POWER RJE default 
definition (POW001) ; nor can you update that definition. 

The POW001 default should be used as an example. However, if you 
wish to assemble the default, you must perform the ADD function of 
VSE/POWER RJE using all the default parameters. This will create a 
new definition containing the same definition as the default. 

JCL DESCRIPTION: 

The JCL generated is a VSE/Advanced Function job stream that contains 
the VSE/POWER and VSE/POWER RJE definition parameters and JCL to 
assemble your VSE/POWER RJE system and link-edit it into user library 
A. 

DIALOG: TSASHAS 

DIALOG NAME: Generate VSE Supervisor Assembly 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: SUPVRGEN 
| SUPVDELX (where X is the last letter 

| in the supervisor name) 

OTHER VSE/ICCF MEMBERS CREATED: TSA$SUP, (TSA$TAW) 

DIALOG DESCRIPTION: 

This dialog presents a series of panels to generate a job stream to 
assemble a supervisor tailored to your installation. The assembly may 
produce a full listing with cross reference based on the option 
chosen. This dialog also allows you to delete set(s) of supervisor 
specifications from Interactive Productivity Facility and the core 
image library. You should delete all specifications that you do not 
use. 

JCL DESCRIPTION: 

The JCL created will assemble a supervisor with the parameters you 
selected from the panels. The supervisor will be link-edited into 
your system core image library (PROD* CORE. IMAGE. A) . 
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DIALOG: UTASFCB 

DIALOG NAME: Maintain FCB 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: CATALFCB 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog helps you assemble and catalog previously tailored 
printer forms control buffers (FCBs) . 

You will be asked to select a function to add, replace, .browse, 
delete, or submit. If you select browse, delete, or submit, you will 
have to specify what FCBs you wish to maintain or submit to VSE. If 
you select submit, a job stream that runs in a VSE partition will be 
created to catalog the FCB phases in the VSE core image library you 
select. 

JCL DESCRIPTION: 

The JCL created by this dialog will assemble and catalog all the 
selected FCB entries in a VSE core image library. After they have 
been cataloged, you can test your new phases by loading them with a 
LFCB operator command or by using the FCB parameter of the VSE/POWER 
LST control statement. If you use the VSE/POWER LST statement, the 
core image library used should have been previously defined in the 
core image library chain (LIBDEF statement) of the VSE/POWER 
partition. 
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DIALOG: UTA$PP1 

[VM/VSE FEATURE BOTE] (This dialog is not supported in the VM/VSE 
environment) 

DIALOG NAME; Print Panels (valid only under VSE/ICCF) 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: PANELIST 

DIALOG DESCRIPTION: 

This activity helps you to create the job stream required to print 
Interactive Productivity Facility panels. It runs in a VSE partition. 
The output from the job is directed to the VSE/POWER punch queue with 
the disposition I and the same priority and class. When this new job 
is executed, it prints the panel list you requested on the logical 
unit SYSLST. 

JCL DESCRIPTION: 

This dialog will produce a job stream to be submitted to VSE. 
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DIALOG: UTASSSL 

[VM/VSE FEATURE NOTE] (This dialog is not supported in the VM/VSE 
environment) 

DIALOG NAME: Select Job from a SYSIN Tape (valid only under 
VSE/ICCF) 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: GETJOB 

OTHER VSE/ICCF MEMBERS CREATED: UTA$JOB 

DIALOG DESCRIPTION: 

This activity helps you to create the job stream required to select a 
job from a SYSIN tape. It will run in a VSE partition. The output 
from the job is directed to the VSE/POWER punch queue. When the job 
is completed, you can read and edit the selected job by issuing the 
VSE/ICCF macro: 3>UTA$JOB; then, it will be ready for modification. 

JCL DESCRIPTION: 

This dialog will produce: 

• A job stream to be submitted to VSE 

• A VSE/ICCF macro 
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DIALOG: OTLSCOP 

DIALOG NAME: Copy Diskette Utilities 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: COPY 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to help you use the COPY DISKETTE utilities by 
prompting you for the proper information to generate the appropriate 
JCL. 

The copy diskette dialog requests the following information: 

• Input diskette address 

• Output diskette address 

• Volume serial number (optional) 

JCL DESCRIPTION: 

The JCL created by this dialog consists of COPY DISKETTE utility 
statements and required assignments. 
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DIALOG: UTLSCHB 

DIALOG NAME: Library Backup 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: CREATE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to assist you in creating JCL to back up your 
system and private libraries to tape. Either the assign control or 
concatenation method of assigning libraries may be used. 

Note: For backup of any system or user library you should use the 
library information dialog to add or change information and use the 
backup library sets dialog of the librarian function to back up the 
libraries. You are prompted to provide the following information: 

Whether you will use the assign or concatenation method of backup 

Which library type you wish to back up 

Tape unit address and optional alternate tape address 

Whether you will use streaming mode for 8809 tape drives 

Whether you wish to create a standalone restore tape 

Whether you wish the core image library sorted 

File ID and volume serial of your DASD 

For concatenation method: 

- Whether you will back up by name, chain, or both ways 

- Name (s) of the libraries you wish backed up by name or chain 

JCL DESCRIPTION: 

The JCL created by this dialog consists of BACKUP utility statements 
and reguired ASSGN or LIBDEF statements. 
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DIALOG: UTLSDHP 

DIALOG NAME: Fast Copy - Backup Disk to Tape 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: DUMP 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in creating JCL to back up files or 
volumes from disk to tape. The backup will be performed by the Fast 
Copy utility. 

The information needed to use Fast Copy is: 

• Whether you wish to copy a volume or a file 

• Tape and DASD address 

• DASD type 

• Volume serial of tape and DASD 

• Whether you will use streaming mode for tape 

• Whether you wish a labeled tape 

• Whether you will exclude certain files 

JCL DESCRIPTION: 

The JCL created by this dialog consists of Fast Copy utility 
statements and required ASSGN statements. 
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DIALOGS 0TLSDSP 

DIALOG NAME: Display VTOC Utilities 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: LVTOC 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to help you use the DISPLAY VTOC utility by 
prompting you for the proper information to generate the appropriate 
JCL. 

The display VTOC dialog requests the following information: 

• Address of disk 

• Printer address (optional) 

JCL DESCRIPTION: 

The JCL created by this dialog consists of DISPLAY VTOC utility 
statements and required assignments. 
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DIALOG: UTLSFCY 

DIALOG NAME: Fast Copy - Copy Disk to Disk 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: FCOPY 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to assist you in creating JCL to copy volumes or 
files from disk to disk. 

The information needed to use Fast Copy is: 

• DASD address 

• DASD type 

• Volume serial 

• Start location 

• For file copy: 

- Start location 

- File length 

JCL DESCRIPTION: 

The JCL created by this dialog consists of Fast Copy utility 
statements and reguired ASSGN statements* 
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DIALOG: OTLSBBS 

DIALOG NAME: Library Restore 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: RESTORE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog is used to assist you in creating JCL to restore your 
system and private libraries from a tape that was created by the 
BACKUP program. Either the assign control or concatenation method of 
assigning libraries may be used. 

Note: For restore of any system or user library you should use the 
library information dialog to add or change information and use the 
restore library sets dialog of the librarian function to restore your 
libraries. 

You are prompted to provide the following information: 

• Whether you will use the assign or concatenation method of backup 

• Which library type you wish to back up 

• Tape unit address and optional alternate tape address 

• Whether you will use streaming mode for 8809 tape drives 

• Whether you wish to create a standalone restore tape 

• whether you wish the core image library sorted 

• File ID and volume serial of your DASD 

• For catenation method: 

— Whether you will back up by name, chain, or both ways 

- Name (s) of the libraries you wish backed up by name or chain 

JCL DESCRIPTION: 

The JCL created by this dialog consists of RESTORE utility statements 
and reguired ASSGN or LIBDEF statements. 
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DIALOG: OTL$RST 

DIALOG NAME: Fast Copy - Restore Tape to Disk 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: RESTORE 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will assist you in creating JCL to restore files or 
volumes from tape to disk. The backup will be performed by the Fast 
Copy utility from tapes dumped by the same utility. 

The information needed to use Fast Copy is: 

• Whether you wish to copy a volume or a file 

• Tape and DASD address 

• DASD type 

• Volume serial of tape and DASD 

• Whether you will use streaming mode for tape 

• Whether you wish a labeled tape 

• Whether you will exclude certain files 

JCL DESCRIPTION: 

The JCL created by this dialog consists of FCOPY utility statements 
and required ASSGN statements. 
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DIALOG: VERSIFY 

DIALOG NAME: Verification Menu 

PREREQUISITE DIALOGS: None 

DEFAULT JOB NAME CREATED: VERCICS, DELCICS, VERDICT, DELDICT, 

VERDITTO, DELDITTO, VERDLI, DELDLI, 
VEREPVS, DELEPVS,VERLOG, DELLOG, 
VERPOWER, DELPOWER, VERSORT, DELSORT, 
VERVSAM, DELVSAM 

OTHER VSE/ICCF MEMBERS CREATED: None 

DIALOG DESCRIPTION: 

This dialog will allow you to create job streams to verify your 
optional products. The same dialog will allow you to delete any 
VSE/VSAM clusters that may have been defined during the verification 
of a product. 

You will be asked to supply the type of disk on which the verify 
files are to be created, and the volume serial number of that disk 
pack. You must use the same disk pack for the verification of all 
products. 

The verify of VSAM must be the first job executed since many other 
products depend on the user catalog and free space that is created by 
this job. Be sure to execute the delete for VSAM when you have 
finished with all other verifies. 

JCL DESCRIPTION: 

The JCL created will depend on what product you selected to verify or 
delete. 
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SECTION 4 - USER OPTIONS FILES 



[Vtt/VSE FEATURE BOTE] If you are a user of the VM/VSE Feature 
running under VM/CMS, refer to the section 'Tailoring Interactive 
Productivity Facility 1 in the Interactive Productivity Facility VM 
Feature UserJ.s Guide. 

The dialog manager, when initiated, searches for a user option file 
(DTE$OPT) that controls six Interactive Productivity Facility 
parameters. This file is optional and if none is found, defaults are 
taken that are assembled within the dialog manager. The user option 
file controls a number of system defaults, including the name of the 
display table. The display table in turn, controls a number of items 
that appear on the Interactive Productivity Facility panels. The 
display table is not optional if invoked by the user option file and 
must be in a VSE/ICCF library to which the user has read/write 
access. 

The sample display table, DTR$DTBL, and user options file, DTR$OPT, 
are also discussed in the Interactive Productivity Fac il ity VSE 
Feature User^s Guide in the section •Interactive Productivity 
Facility User Options File 1 . 

The most significant reason for changing the options is to change the 
language of the panels and the corresponding responses. 

The items that can be specified in the user option file are: 

• Whether messages displayed should have the message number and 
environment identity. Default is NO. 

• Name of the default initial panel. Default is DTR$. 

• Case in which to display panels (either mixed or uppercase) . 
Mixed case can only be displayed if the terminal has the hardware 
feature. The default is mixed case. 

• Name of the display table containing the tables to be used by the 
display service function of the dialog manager. Default is NO. 
If NO is specified, constants within the dialog manager are used. 

The display table controls the following Interactive Productivity 
Facility items: 

• A direction table containing the direction lines for all the 
panels. 

• A selection table containing the selection lines for all the 
panels. 

• A synonym table of up to 70 synonyms for Interactive Productivity 
Facility responses. 
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I • Program function key settings for interactive Productivity 
I Facility responses for all panels in a PF key table. 

I 

I • A connect table that relates Interactive Productivity Facility 

| member prefixes with the VSE/ICCF sublibrary in which they 

| reside. (The dialog manager uses the connect table to switch to 

1 a particular library to retrieve an item.) 

I 

| Although you may change these items at any time, the changes will not 

j be in effect until you leave and then reenter Interactive 

( Productivity Facility. 

I 

I Sample user options and display tables are shipped in VSE/ICCF 

I library 58. The name of the supplied options file is DTR$OPT. The 

j name of the supplied display table is DTR$DTBL. Both tables can be 

I altered and activated to change any of the above items. 

I 

| The following example illustrates how to move the sample user options 

j and the display tables to a user's library. This will alter the 

j options to those in the supplied default display table. 

I 

After logging on to VSE/ICCF, enter the following commands: 

/COHHect 58 (Connect to library 58) 

SCOPYFILE DTBSOPT DTB$OPT (Put into your library) 

acOPYFILE DTR$DTBL DTB$DTBL (Put into your library) 

/COHHect OFF (Disconnect from library 58) 

9ED DTBSOPT (Edit the option file) (at sign) ED 

Now change the line DSPTABLE = NO to DSPTABLE = DTR$DTBL. 

Note that options will only be changed for the ID associated with the 
library into which the two tables are placed. If the change is to be 
system wide, the tables must be placed in each user library for which 
the changes are desired. 

If you wish to move Interactive Productivity Facility members from 
the standard sublibraries (51 through 67) to other sublibraries, the 
numbers of the other sublibraries must be less than 99. Otherwise, 
the results are unpredictable. 
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DIRECTIOI TABLE 



This table provides the action messages that appear on the second 
line of an Interactive Productivity Facility panel. Different types 
of panels (menu, entry, and explain) display different action 
messages. You can modify the messages that appear on panels by making 
changes in this table. The primary reason for modifying the messages 
would be to change them to a non-English language. 



| *DIRTABLE 

I * 

| * DIRECTION LINE FOR MENU PANELS 

| Select the activity you wish to perform. 

| * DIRECTION LINE FOR IMENU PANELS 

j Select the category of information you wish to review. 

| * DIRECTION LINE FOR DMENO PANELS 

| Select an option from the following list. 

| * DIRECTION LINE FOR ENTRY PANELS 

| Enter the required data and press enter. 

| * DIRECTION LINE FOR UENTRY PANELS 

| Enter the required data and press enter. 

| * DIRECTION LINE FOR EXPLAIN PANELS - ONLY ONE PAGE 

| END leaves explanation. 

| * DIRECTION LINE FOR EXPLAIN PANELS - FIRST PAGE OF MULTI 

j END leaves explanation, FORWARD continues explanation. 



I * 



DIRECTION LINE FOR EXPLAIN PANELS - MIDDLE PAGE OF MULTI 



| END leaves explanation, FORWARD or BACK continues explanation. 



I * 



DIRECTION LINE FOR EXPLAIN PANELS - LAST PAGE OF MULTI 



| END leaves explanation, BACK continues explanation. 

| * DIRECTION LINE FOR NOREAP PANELS 

| Function in process, no action required. 

I * 



Figure 4. Direction table 
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SSLBCTXOH TABLE 



This table provides the selection lines that appear on the last line 
of an Interactive Productivity Facility panel. The selection line 
contains the services that are valid for the panel on which they 
appear. You can modify the mnemonic word that is displayed as long as 
the new one is a valid Interactive Productivity Facility service 
command or a synonym defined in the synonym table Figure 6 on page 
140. For example, the standard selection line for an entry panel is: 



PF1 = EXPL 



3=CANCEL 



5=RETRY 



If you did not have program function keys, you could change the 
selection line to: 



EXPLAIN 



CANCEL 



RETRY 



♦SELTABLE 

PF1=EXPL 

PF1=0VER 

PF1=EXPL 
* 

PF1=EXPL 

PF1=EXPL 

PF1=0VER 
* 

PF1=0VER 

PF1=0VER 

PF1=0VER 
* 



SELECTION LINE FOR 
3=RETURN 4=ICCF 6- 
SELECTION LINE FOR 
3=END 6-INIT 
SELECTION LINE FOR 

3=CANCEL 
SELECTION LINE FOR 

3=CANCEL 
SELECTION LINE FOR 

3=CANCEL 
SELECTION LINE FOR 

3=END 
SELECTION LINE FOR 

3=END 
SELECTION LINE FOR 

3=END 
SELECTION LINE FOR 

3=END 



MENU PANEIS 

=INIT 

IMENU PANEIS 

DMENU PANELS 
5=RETRY 

ENTRY PANELS 
5=RETRY 

UENTRY PANELS 
5=RETRY 

EXPLAIN PANELS 



- ONLY ONE PAGE 



EXPLAIN PANELS - FIRST PAGE OF MULTI 

8=FORH 
EXPLAIN PANELS - MIDDLE PAGE OF MULTI 

7=BACK 8=FORW 
EXPLAIN PANELS - LAST PAGE OF MULTI 

7=BAC!I 



Figure 5. Selection table 
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SJIQHYH TABLE 

This table provides the synonyms that the Interactive Productivity 
Facility Dialog Manager can use. For example, the Dialog Manager 
knows the words EXPLAIN, CANCEL, and RETRY. Assume you wanted to 
change the selection line of a data entry panel to French so it would 
appear as follows: 

EXPLIQUE ANNULE REFAIT 

You would have to do two things: 

• Change the selection line in the selection table as shown. 

• Define the French words in the synonym table as follows: 

EXPLAIN EXPLIQUE 
CANCEL ANNULE 
RETRY REFAIT 

You may also wish to change the synonym for YES to OUI, and NO to 
NON. 

Caution: You should not define a synonym for YES or NO longer than 
three characters. You should not change OPSYS to anything other than 
DOS. If you make either of these changes, the results are 
unpredictable. 
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♦SYNTABLE 
EXPLAIN EXPLAIN 
EXPLAIN 1=EXP 
EXPLAIN EXP 
EXPLAIN EXPL 
RETRY RETRY 
RETRY 5=RETRY 
MOREINFOOVERVIEW 
MOREINF01=OVER 
MOREINFOOVER 
RETURN RETURN 



RETURN 


3=RETN 


RETURN 


RETN 


QUIT 


CANCEL 


QUIT 


3=CANCEL 


RESTART 


INITIAL 


RESTART 


6=INIT 


RESTART 


INIT 


EXIT 


ICCF 


EXIT 


4=ICCF 


ENDEXPL 


END 


ENDEXPL 


3=END 


FORWARD 


FORWARD 


FORWARD 


8=FORW 


FORWARD 


FORW 


BACK 


BACK 


BACK 


7=BACK 


PAGE 


PAGE 


YES 


YES 


NO 


NO 


OPSYS 


DOS 



UTILITY UTILITY 



Figure 6. Synonym table 
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P? SMI TABLE 

This table defines the service command to be executed when you press 
a particular program function (PF) key. Each entry in the table 
corresponds to a PF key. The first entry corresponds to PF key 01, 
the second entry to PF key 02, etc. If no command is assigned to a 
particular PF key, the entry PFKEY-nn appears, where nn is the number 
of that PF key. For example, the first line of the table below, for 
menu panels, is as follows: 

EXPLAIN PFKEY-2 RETURN ICCF PFKEY-5 INITIAL 

EXPLAIN corresponds to PF key 01 ; there is no command assigned to PF 
key 02, so the entry PFKEY-2 appears; RETURN corresponds to PF key 
03; ICCF corresponds to PF key 04; there is no command assigned to PF 
key 05, so the entry PFKEY-5 appears; and INITIAL corresponds to PF 
key 06. 

When a menu panel is displayed, if you press PF1, PF3, PF4, or PF6, 
the corresponding service will be executed. If you press PF2 or PF5, 
no service will be executed and the following message will appear: 

PFKEY-nn is not a valid response. 

You may wish to rearrange or duplicate PF keys. For example, you can 
have 24 PF keys and have PF key 01 and PF key 13 both defined as 
EXPLAIN. If you change the PF key assignments, you can also change 
the selection table, as noted above, to reflect the new PF key 
definitions. 

Caution: You should not add additional services to the PF key table. 
For example, the menu panel does not have RETRY as a possibility. Do 
not add RETRY. However, you can rearrange services as noted above. 
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I * 

I *PFKTABLE 

| * PFKEY TABLE FOR MENU PANELS 

| EXPLAIN PFKEY-2 RETURN ICCF PFKEY-5 INITIAL 

| PFKEY-7 PFKEY-8 PFKEY-9 PFKEY-10PFKEY-1 1PFKEY-12 

| EXPLAIN PFKEY-1 4RETURN ICCF PFKEY-17INITIAL 

( PFKEY- 19PFKEY-20PFKEY-21PFKEY-22PFKEY-23PFKEY-24 

I * 

| * PFKEY TABLE FOR IMENU PANELS 

| OVERVIEWPFKEY-2 END PFKEY-4 PFKEY-5 INITIAL 

| PFKEY-7 PFKEY-8 PFKEY-9 PFKEY-10PFKEY-1 1PFKEY-12 

| GVERVIEWPFKEY-14END PFKEY-1 6PFKEY-17INITIAL 

i PFKEY- 19PFKEY-20 PFKEY-2 1PFKEY-22PFKEY-23PFKEY-24 

I * 

| * PFKEY TABLE FOR DMENU PANELS 

| EXPLAIN PFKEY-2 CANCEL PFKEY-4 RETRY PFKEY-6 

| PFKEY-7 PFKEY-8 PFKEY-9 PFKEY-10PFKEY-1 1PFKEY-12 

| EXPLAIN PFKEY-14CANCEL PFKEY-16RETRY PFKEY-18 

| PFKEY- 19PFKEY-20PFKEY-21PFKEY-22PFKEY-23PFKEY-24 

I * 

| * PFKEY TABLE FOR ENTRY PANELS 

| EXPLAIN PFKEY-2 CANCEL PFKEY-4 RETRY PFKEY-6 

I PFKEY-7 PFKEY-8 PFKEY-9 PFKEY-10PFKEY-1 1PFKEY-12 

| EXPLAIN PFKEY-14CANCEL PFKEY-16RETRY PFKEY-18 

I PFKEY-1 9PFKEY-20 PFKEY-2 1PFKEY-22PFKEY-23PFKEY-24 

I * 

| * PFKEY TABLE FOR OENTRY PANELS 

| EXPLAIN PFKEY-2 CANCEL PFKEY-4 RETRY PFKEY-6 

| PFKEY-7 PFKEY-8 PFKEY-9 PFKEY-1 OPFKEY-1 1PFKEY-12 

| EXPLAIN PFKEY-1 4CANCEL PFKEY-1 6RETRY PFKEY-18 

| PFKEY-1 9PFKEY-20 PFKEY-2 1PFKEY-22PFKEY-23PFKEY-24 

I * 

| * PFKEY TABLE FOR EXPLAIN PANELS - ONLY ONE -PAGE 

| OVERVIEWPFKEY-2 END PFKEY-4 PFKEY-5 PFKEY-6 

| PFKEY-7 PFKEY-8 PFKEY-9 PFKEY-10PFKEY-1 1PFKEY-12 

| OVERVIEWPFKEY-14END PFKEY-1 6PFKEY-17PFKEY-1 8 

| PFKEY-1 9PFKEY-20 PFKEY-2 1PFKEY-22PFKEY-23PFKEY-24 

I * 

| * PFKEY TABLE FOR EXPLAIN PANELS - FIRST PAGE OF MULTI 

| OVERVIEWPFKEY-2 END PFKEY-4 PFKEY-5 PFKEY-6 

| PFKEY-7 FORWARD PFKEY-9 PFKEY-10PFKEY-1 1PFKEY-12 

| OVERVIEWPFKEY-14END PFKEY-1 6PFKEY-1 7PFKEY-18 

| PFKEY-1 9PFKEY-20PFKEY-21PFKEY-22PFKEY-23PFKEY-24 

I * 



Figure 7 (Part 1 of 2) . PF key table 
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I * 

I * PFKEY TABLE FOR EXPLAIN PANELS - MIDDLE PAGE OF MULTI 

| OVERVIEWPFKEY-2 END PFKEY-4 PFKEY-5 PFKEY-6 

| BACK FORWARD PFKEY-9 PFKEY-10PFKEY-1 1PFKEY-12 

| OVERVIEWPFKEY-14END PFKEY-1 6PFKEY-17PFKEY-18 

| BACK FORWARD PFKEY-21PFKEY-22PFKEY-23PFKEY-24 

I * 

I * PFKEY TABLE FOR EXPLAIN PANELS - LAST PAGE OF MULTI 

| OVERVIEWPFKEY-2 END PFKEY-4 PFKEY-5 PFKEY-6 

| BACK PFKEY-8 PFKEY-9 PFKEY- 10PFKEY-1 1PFKEY-12 

| OVERVIEWPFKEY-14END PFKEY-1 6PFKEY-17PFKEY- 18 

| BACK PFKEY-20PFKEY-21PFKEY-22PFKEY-23PFKEY-24 

I * 

I 

Figure 7 (Part 2 of 2) . PF key table 



COHHECT TABLE 

An Interactive Productivity Facility member can be one of the 
following: 

• A panel 

• A message file 

• A table 

• A skeleton 

To locate an Interactive Productivity Facility member from the 
VSE/ICCF library, the dialog manager needs the following three 
parameters: 

• The prefix of the member name 

• The type of the member 

• The VSE/ICCF sublibrary containing the member if it is not ija the 
user VSE/ICCF sublibrary 

The prefix is the first three characters of the member name. 

The type of a member is as follows: 

• DTRTABLE for a table 

• DTRSKEL for a skeleton 
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• DTRPANEL for a panel 

• DTRMSG for a message file 

The number that follows the type is the number of the VSE/ICCF 
sublibrary. 

The connect table contains the information needed to retrieve an 
Interactive Productivity Facility member. 

This is an example of how the dialog manager determines 'the 
sublibrary where a member can be located. 

Assume the Interactive Productivity Facility dialog manager is 
looking for the table ADM$SHIP. The dialog manager scans the connect 
table to find the entry ADM (member prefix) . Since ADM$SHIP is a 
table, the entry must be ADM DTRTABLE. We can see in the connect 
table below that the sublibrary number is 51* 

The VSE/ICCF connect table is part of the display table pointed to by 
the Interactive Productivity Facility user options fil/?. 

Vote: The connect table is loaded in main storage at Interactive 
Productivity Facility initialization time. Therefore, no I/Os are 
necessary to locate a connect table entry. Any change to this table 
takes effect the next time that Interactive Productivity Facility is 
invoked after the change. 

The last entry in the connect table is all Fs to mark the end of the 
table. It is precee^ed by entries with prefixes of asterisks. These 
entries must be the last entries in the table (other than the entry 
of all Fs) . They show which VSE/ICCF library to search if the prefix 
value has not yet been found. For example, a prefix of MBL does not 
exist in the table. If a prefix of MBL were recognized, library 58 
would be searched for MBL items because the asterisk entries 
reference library 58. 

In order to add an entry to the connect table, you must have an 
active user options file and display table in your primary library. 
You must modify the connect table in the same format as given below 
for each of the member types with the appropriate prefix. If you add 
a new prefix, you must add all four member types whether they exist 
or not. For example, if you want to add a product to the Interactive 
Productivity Facility menu hierarchy with a prefix of MBL, execute 
the following steps: 

• Add the product to the VSE/ICCF libraries. Assume you added the 
panels to library 70 and the rest of the members to library 71. 

• Copy DTRSOPT and DTR$DTBL from library 58 to your primary 
library. 

• Change the line DSPTABLE=NO to DSPTABLE=DTR$DTBL in DTR$OPT. 
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Add MBL DTRPANEL 70, MBL DTRMSG 71 , MBL DTRTABLE 71, and MBL 
DTRSKEL 71 to the DTR$DTBL connect table in the line before the 
asterisk prefix line. 

Use the ENV$DEF dialog to add the MBL$ menu used to enter the 
product dialog to the Interactive Productivity Facility menu 
hierarchy. 

You can change the initial menu to MBL$ in DTRSOPT. This would 
cause menu MBL$ to appear when the initial command is entered. 
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\ *CONTABLE 
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1 

| ADM 


DTRPANEL 


66 


ADM 


DTRMSG 


51 


ADM 


DTRTABLE 


51 


| INS 


DTRPANEL 


52 


INS 


DTRMSG 


52 


INS 


DTRTABLE 


52 


| VER 


DTRPANEL 


52 


VER 


DTRMSG 


52 


VER 


DTRTABLE 


52 


| DEL 


DTRPANEL 


52 


DEL 


DTRMSG 


52 


DEL 


DTRTABLE 


52 


| TCI 


DTRPANEL 


53 


TCI 


DTRMSG 


53 


TCI 


DTRTABLE 


53 


| SYI 


DTRPANEL 


54 


SYI 


DTRMSG 


54 


SYI 


DTRTABLE 


54 


I SRV 


DTRPANEL 


67 


SRV 


DTRMSG 


55 


SRV 


DTRTABLE 


55 


| TAS 


DTRPANEL 


56 


TAS 


DTRMSG 


56 


TAS 


DTRTABLE 


56 


I TPW 


DTRPANEL 


56 


TPW 


DTRMSG 


56 


TPW 


DTRTABLE 


56 


I TRJ 


DTRPANEL 


56 


TRJ 


DTRMSG 


56 


TRJ 


DTRTABLE 


56 


| ENV 


DTRPANEL 


57 


ENV 


DTRMSG 


57 


ENV 


DTRTABLE 


57 


I TSA 


DTRPANEL 


57 


TSA 


DTRMSG 


57 


TSA 


DTRTABLE 


57 


t UTA 


DTRPANEL 


57 


UTA 


DTRMSG 


57 


UTA 


DTRTABLE 


57 


| TEP 


DTRPANEL 


57 


TEP 


DTRMSG 


57 


TEP 


DTRTABLE 


57 


| TUW 


DTRPANEL 


57 


TUW 


DTRMSG 


57 


TUW 


DTRTABLE 


57 


| AEM 


DTRPANEL 


60 


AEM 


DTRMSG 


60 


AEM 


DTRTABLE 


60 


1 LIB 


DTRPANEL 


60 


LIB 


DTRMSG 


60 


LIB 


DTRTABLE 


60 


1 UTL 


DTRPANEL 


60 


UTL 


DTRMSG 


60 


UTL 


DTRTABLE 


60 


| ELI 


DTRPANEL 


61 


ELI 


DTRMSG 


61 


ELI 


DTRTABLE 


62 


I DLZ 


DTRPANEL 


63 


DLZ 


DTRMSG 


63 


DLZ 


DTRTABLE 


63 


| AMS 


DTRPANEL 


65 


AMS 


DTRMSG 


65 


AMS 


DTRTABLE 


65 


| CAT 


DTRPANEL 


65 


CAT 


DTRMSG 


65 


CAT 


DTRTABLE 


65 


| DSF 


DTRPANEL 


65 


DSF 


DTRMSG 


65 


DSF 


DTRTABLE 


65 


| SPC 


DTRPANEL 


65 


SPC 


DTRMSG 


65 


SPC 


DTRTABLE 


65 


| *** 


DTRPANEL 


58 


*** 


DTRMSG 


58 


*** 


DTRTABLE 


58 


| *** 


DTRELOG 


58 


*** 


DTROPT 


58 


*** 


DTRTRCE 


58 



ADM DTRSKEL 51 

INS DTRSKEL 52 

VER DTRSKEL 52 

DEL DTRSKEL 52 

TCI DTRSKEL 53 

SYI DTRSKEL 54 

SRV DTRSKEL 55 

TAS DTRSKEL 56 

TPW DTRSKEL 56 

TRJ DTRSKEL 56 

ENV DTRSKEL 57 

TSA DTRSKEL 57 

UTA DTRSKEL 57 

TEP DTRSKEL 57 

TUW DTRSKEL 57 

AEM DTRSKEL 60 

LIB DTRSKEL 60 

UTL DTRSKEL 60 

ELI DTRSKEL 62 

DLZ DTRSKEL 63 

AMS DTRSKEL 65 

CAT DTRSKEL 65 

DSF DTRSKEL 65 

SPC DTRSKEL 65 

*** DTRSKEL 58 
FFFFFFFFFFFFFFFF 



Figure 8. VSE/ICCF connect table 
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SECTIOM 5 - SDBVSE BEQUIBEMEHTS 



£¥M/¥SB FEATURE IOTE] This section contains information for the 
VM/VSE user. If you are not using the VM/VSE Feature, skip this 
section. 



MODIFICATIOH DOME BY SUBVSE EXEC 

The job stream punched to the VSE machine is modified by this 
function to provide standard interfaces to the ROOTER facility and 
the VSE/VMCF communication facility. Access to the 19E Y disk and the 
301 V disk is required for submitting jobs to VSE. 

SUBVSE modifies the POWER jobname. If the POWER name of the job that 

you submit is LISTIOBG, then SUBVSE will change this to XXXLISTI, 

where XXX is your prefix in the SUB$VSET table. The output of the job 
will be returned to your virtual reader. 

SUBVSE also modifies each DOS job card. The specification of 
VSE/VMCF options is done on the DOS job card. If job accounting is 
not in use, the VSE/VMCF options are added immediately after the job 
name. If job accounting is in use, the VSE/VMCF options are added 
immediately after the end of the job name plus 17 bytes for the job 
accounting information. 

The table that ROUTER uses is shown below in the topic •Sample 
Shipped SUB$VSET DTRTABLE'. This is the supplied table and you should 
modify tuis as described in SUB$VSET TABLE MAINTENANCE. In the table 
each CMS user has a three digit job prefix associated with it. This 
prefix starts in column 17. 



VSE VIRTUAL HACHIHE CABD READER 

The VSE virtual machine VSEIPO is shipped with a virtual 3505 reader 
defined at virtual address 00C. Card decks loaded into the real 
system reader for VM with an ID VSEIPO header card and files punched 
from other virtual machines will be received at 00C. A VSE/POWER 
reader task is started to read these files. A virtual card reader is 
necessary to receive files from other virtual machines. 

Users with more than one real reader or users with most or all of 
their card input going to the VSE virtual machine may wish to attach 
a real reader to the VSE virtual machine. The real reader can be 
defined to CP with the ATTACH CP command or the DEDICATE directory 
statement. The additional address must be defined at VSE IPL time 
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with the ADD IPL command. A second VSE/POWER reader task can be 
started to read these files. To prevent interference with the 
virtual reader, any new reader must have an address above 00c. The 
reader at address 00c is auto-started to support files spooled from 
other virtual machines. 



VSE VIRTUAL MACHINE CABD PUNCH 

The VSE virtual machine VSEIPO is shipped with virtual 3525 punches 
at virtual addresses 00D and 05D and with virtual 1403 printers at 
virtual addresses 00E and 05E. To make use of the ROUTER facility, 
which will return the output of jobs run on a VSE virtual machine to 
the reader of the submitter's virtual machine, the virtual printer at 
05E and the virtual punch at 05D have been spooled to the ROUTER 
virtual machine. This is done in the PROFILE EXEC for VSEIPO. 

Users who do not want all output files to go through the ROUTER 
facility should separate the output files by using different 
VSE/POWER spool classes. The ROUTER facility uses the VSE/POWER 
class R. The virtual printer at 00E and the virtual punch at 00D 
have been directed to the VM system printer and punch with the CP 
SPOOL VADDR OFF command in the PROFILE EXEC for VSEIPO. You may wish 
to modify 00E and 00D in the VM directory to ATTACH a real printer or 
punch at those addresses. 



ROUTER 

The ROUTER facility is a CMS virtual machine that can run 
disconnected. It is part of the VM/SP System IPO/E. It examines the 
filename of every reader file it receives and compares the first 
three characters with the jobname prefix in the SUB$VSET DTRTABLE 
file. If a match is found, the reader file is transferred to the CMS 
user ID defined in the table. If a match is not found, the reader 
file is scheduled to be printed or punched by the CP system. The 
ROUTER facility is initialized by executing the SUB$RTR EXEC. 



S0B$¥SET TABLE MAINTENANCE 

Part of the job of maintaining the CP Directory includes the 
maintenance of a SUB$VSET DTRTABLE file. This table must contain the 
user ID and jobname prefix for each user who will be submitting jobs 
to the VSE virtual machine. The jobname prefix should be three 
alphameric characters long and unique to each user ID. 

The SUB$VSET DTRTABLE file is initially shipped on the 19E Y disk. 
The user-modified file should be written and maintained on the 320 H 
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disk. This requires that maintenance be done on the user ID MAINT, 
which is the only user ID that has R/W access to the 320 H disk. 

■ote: Files whose file type is DTRTABLE are column dependent. The 
userid must begin in column 9 and the jobname prefix must begin in 
column 17. 



SAMPLE SHIPPED S0B£VSET DTE TABLE 

This is the shipped SUB$VSET DTRTABLE as found on the 19E minidisk. 
The column count is placed here for you to identify the format of the 
table. 



Column 

000000000111111111122222222223 

123456789012345678901234567890 

$$$002**USERID PREFIX 

$$$002**X K 
$$$00 2**VSEMAINTVMT 

$$$002**CMS1 C01 

$$$002**CMS2 C02 

$$$002**CMS3 C03 

$$$002**CMS4 C04 

$$$002**CMS5 C05 

$$$002**CMS6 C06 

$$$002**CMS7 C07 

$$$002**CMS8 C08 

$$$002**CMS9 C09 

$$$002**CMS10 C10 

$$$002**CMS11 C11 

$$$002**CMS12 C12 

$$$002**CMS13 C13 

$$$002**CMS14 C14 

$$$002**CMS15 C15 

$$$002**CMS16 C16 

$$$002**CMS17 C17 
$$$EOF** 

000000000111111111122222222223 
123456789012345678901234567890 
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APPENDIX is. SERVICE LIBRARY FDLL PROBLEMS 



HSGM211I and MSGM212I may occur during the application of POT tapes 
or large amounts of corrective service to the service libraries. 
These messages occur during the application of service because the 
service libraries do not have enough room for the serviced members. 
This may occur because the service adds more or larger members to the 
service library. Also, the service you are applying may add many 
members to the service library temporarily. For example, service to 
the VSE/ICCF libraries may add I. books to the service source library 
temporarily. These books are used as input to DTSUTIL and then 
deleted from the service libraries. However, the service library must 
have enough space to hold these books during service application. 

You may bypass this problem in two ways. The first is to make the 
service libraries larger by splitting them onto different packs. The 
second is to temporarily decrease the service library contents by 
deleting some members during service application. The following text 
is an example of each of these methods for service library set A for 
a 3340 user. The values given for the library sizes are examples 
only. Consult your system profile for the real values on your 
system. 



SPLIT YOUR SEBVICB LIBRARIES 

The first bypass is the preferred method. In this case you should 
change the size and location of SERVICE. STSRLB. A and 
SERVICE. SYSSLB. A. Then you may apply service with larger libraries 
for service A. A 3340 user needs another pack available as a work 
volume for the service libraries. The following steps are required: 

1. Use the Interactive Productivity Facility to change the size and 
location of SERVICE. SYSRLB. A and SERVICE. SYSSLB. A. After you log 
onto the Interactive Productivity Facility, enter =ADM$1 on the 
input line at the bottom of the screen. This will give you the 
system profile menu. Select 4* LIBRARY INFORMATION. Then select 
2, PRODUCTION/SERVICE LIBRARIES, then select 3, UPDATE LIBRARY. 
Enter an update library of SRVRLA under RL and SRVSLA under SL. 
For the SRVRLA library we are going to change the library 
allocation as follows: 

OLD LIBRARY NEW LIBRARY OLD DIRECTORY NEW DIRECTORY 
ALLOCATION ALLOCATION ALLOCATION ALLOCATION 



307 575 13 24 

Then use the dialog you are already in to change the allocation 
and location of SERVICE. SYSSLB. A as follows: 
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LIBRARY DIRECTORY 

ALLOCATION ALLOCATION STARTING ADDRESS 



575 24 1332 

Mote: The above location is for a 334 user. A 3340 user or mixed 
DASD user with SYSWK2 and SYSWK3 as 334 0»s must use an additional 
volume for SERVICE. SYSSLB. A. This additional volume serial 
number must also be entered at this time. If the new volume is 
not a 3340, it must be a CKD device such as a 3330 or 3350. Also, 
the new volume will not appear in SRV$FLOW, the service flow 
diagram. However, the proper JCL will be generated. SRV$FLOW 
assumes both service libraries of a set are on the same volume. 

2. You must run the Interactive Productivity Facility service dialog 
after the above library allocation changes have been made. 

3. If the service libraries are not resident on a pack and are not 
going to be restored to the default volumes (SYSWK2 and SYSWK3 
for a 3340 user) do this step. 

Do the following iteps for your additional volume (assumed to be a 
3340) : 

1 . Fast Copy the volume you added to the library allocation for 
SERVICE* SYSSLB. A. You may use the utilities dialog for that. 

2. Initialize the 3340* This is optional as long as the VTOC on the 
3340 does not include the tracks you put the library on. You may 
use the job which follows as a model: 

// JOB INIT3340 

// ASSGN SYS000,1C4 IC4 = 3340 

// EXEC ICKDSF,SIZE=130K 
INIT SYSNAME(SYSOOO) NVFY DEVTYP (3340) - 
PRG DVTOC(690,0,12) 

/* 

/& 

Use the output of the service dialog to apply the service. If you had 
an additional volume you just fast copied, then use the utilities 
dialog to restore the additional 3340 volume. You must backup and 
restore the additional volume yourself because the service dialogs 
will not do it for you. The service dialogs will only backup/restore 
SYSWK2 and SYSWK3. 



DECREASE SERVICE LIBRABY CONTENTS 



The second bypass is not recommended except if the first bypass 
reguires more DASD space than you have available. 
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The second bypass is to apply the service in two passes. We will 
assume you are applying a PUT. In pass one apply service to all 
products except VSE/ICCF. Do this by excluding the VSE/ICCF CLC, 
which is G97. In pass two use the selective PUT dialog to apply 
service to VSE/ICCF only. Include the service for CLC G97 (ICCF) 
only on the second pass. You will also have to delete some members 
from the SRVRLA and SRVSLA libraries. 

naming: You must restore the new SYSRES from pass one before doing 
pass two. If you do not, pass two will use old SYSRES phases and 
your system will be unusable. 

During pass two, immediately after checkpoint 1 is the job to restore 
service library A. After SRVRLA and SRVSLA are restored, you are 
reguested to return the input tape to your tape library and a pause 
command is issued. During this pause command, run the following two 
jobs in another partition. In the case of the following example, F4 
was used. 

* $$ JOB JNM=PUNCHR,CLASS=4,DISP=D,PRI=3 
// JOB PUNCHR 

* THIS JOB PUNCHES IFC. ALL AND DELETES IPC. ALL 

* FROM SRVRLA 

// DLBL SRVRLA, 1 SERVICE. SYSRLB.A' 
// EXTENT ,SYSWK2,1,0 
// LIBDEF RL,FROM=SRVRLA 

* MOUNT A SCRATCH TAPE ON XXX FOR OUTPUT FOR THIS JOB 
// PAUSE 

// ASSGN SYSPCH,XXX SUBSTITUTE YOUR TAPE FOR XXX 

// MTC REW,SYSPCH 

// EXEC RSERV 

PUNCH IFC. ALL 

/* 

// MTC WTM,SYSPCH,2 

// MTC REW,SYSPCH 

* REMOVE THE TAPE ON XXX AND LABEL IT "SRVA RELO PUNCH" 

* MAKE SURE THE TAPE REWINDS PROPERLY, YOU NEED IT LATER 

* CANCEL THIS JOB IF THE TAPE DID NOT REWIND PROPERLY 
// PAUSE 

// DLBL SRVRLA, • SERVICE. SYSRLB. A • 
// EXTENT ,SYSWK2,1,0 
// LIBDEF RL,FROM=SRVRLA,TO=SRVRLA 
// EXEC MAINT 

DELETR IFC. ALL 
/* 
/& 

* $$ EOJ 
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* $$ JOB PNM=PUNCHS,CLASS=4,DISP=D, PRI=3 
// JOB PUNCHS 

* THIS JOB PUNCHES AND DELETES SOME SUPERVISOR MACROS FROM 

* SRVSLA. MAKE SURE YOU PUNCH AND DELETE THE SAME MEMBERS, 
// DLBL SRVSLA, 1 SERVICE. SYSSLB.A 1 

//EXTENT ,SYSWK2,1,0 
// LIBDEF SL,FROM=SRVSLA 

* MOUNT A SCRATCH TAPE ON XXX FOR OUTPUT FOR THE JOB 
// PAUSE 

// ASSGN SYSPCH,XXX 

// MTC REW,SYSPCH 

// EXEC SSERV 

PUNCH E.SGCCWF,E.SGCCWT,E. SGAM,E.SGPMR,E*SGDFCH 

PUNCH E. SGPFIX,E.IOINTER,E.SGDSK,E. SGEND,E* SGIOS 

/* 

// MTC WTM,SYSPCH,2 

// MTC REW,SYSPCH 

* REMOVE THE TAPE ON XXX AND LABEL IT «SRVA SOURCE PUNCH* 

* MAKE SURE THE TAPE REWINDS PROPERLY, YOU NEED IT LATER 

* CANCEL THIS JOB IF THE TAPE DID NOT REWIND PROPERLY 
// PAUSE 

// DLBL SRVSLA, •SERVICE. SYSSL3. A 1 

// EXTENT ,SYSWK2,1,0 

// LIBDEF SL,FROM=SRVSLA,TO=SRVSLA 

// EXEC MAINT 

DELETS E.SGCCWF,E. SGCCWT,E.SGAM,E. SGPMR, E. SGDFCH 

DELETS E.SGPFIX,E.IOINTER,E. SGDSK, E. SGEND,E. SGIOS 

/* 

/& 

* $$ EOJ 

The same concept holds true for different service library sets. You 
must punch out and then delete some members of a product you are not 
applying service to in order to get some room. Then you may apply 
service with the space you gained. If you only have one product in a 
library, you must find room on another pack somewhere for the service 
libraries. 

After the above jobs have run, save the two output tapes and let pass 
two of the PUT application continue. The condense of these libraries 
will be done by MSHP, If you still are short of room in the source 
library on some future PUT, you can add more books to the punch and 
delete lists. The macros whose names begin the E. SG are SYSGEN 
macros. They are good candidates for this process. 

After the I. books are applied to VSE/ICCF in the job commented, 
"APPLY SERVICE TO THE VSE/ICCF LIBRARIES", you will have a pause 
which tells you to scratch the work tape you have mounted. At this 
point you should run the following two jobs to once again restore the 
library members you punched in the jobs above. 
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* $$ JOB JNM=CATALR,CLASS=4,DISP=D,PRI=3 
// JOB CAT ALB 

// DLBL SRVRLA, 1 SERVICE, SYSRLB. A 1 

// EXTENT ,SYSWK2,1,0 

// LIBDEF RL,FROM=SRVRLA,TO=SRVRLA 

* MOUNT THE TAPE YOU LABELED "SRVA RELO PUNCH" ON TAPE XXX 
// PAUSE 

// ASSGN SYSIPT,XXX WHERE XXX IS YOUR TAPE DRIVE 
// MTC REW,SYSIPT 
// EXEC MAINT 

/* 

// MTC RUN,SYSIPT 

* YOU MAY DISCARD SRVA RELO PUNCH IF THIS JOB RAN CORRECTLY 
// PAUSE 

/& 

* $$ EOJ 

* $$ JOB JNM=CATALS,CLASS=4,DISP=D,PRI=3 
// JOB CATALS 

// DLBL SRVSLA, 'SERVICE. SYSSLB.A* 
// EXTENT ,SYSWK2,1,0 
//LIBDEF RL,FROM=SRVSLA,TO=SRVSLA 

* MOUNT THE TAPE YOU LABELED "SRVA SOURCE PUNCH" ON TAPE XXX 
// PAUSE 

// ASSGN SYSIPT,XXX WHERE XXX IS YOUR TAPE DRIVE 
// MTC REW,SYSIPT 
// EXEC MAINT 

/* 

// MTC RUN,SYSIPT 

* YOU MAY DISCARD SRVA SOURCE PUNCH IF THIS JOB RAN CORRECTLY 
// PAUSE 

/& 

* $$ EOJ 

After the above jobs have successfully run, you may let the rest of 
the apply PUT for pass two finish. This technique should work 
because the libraries have the needed room. If you do find that 
SRVSLA is short of room, rerun the delete job and then run the 
following job to condense SRVSLA. 

* $$ JOB JNM=CONDNS,CLASS=4,DISP=D,PRI=3 
// JOB CONDNS 

// DLBL SRVSLA, 'SERVICE. SYSSLB.A' 

// EXTENT ,SYSWK2,1,0 

// LIBDEF SL,FROM=SRVSLA,TO=SRVSLA 

// EXEC MAINT 

CONDS SL 

/* 
/S 

* $$ EOJ 

Then rerun the CATALS job. 
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APPENDIX B* DEBUGGING ABEND DH09 



ABEND DM09 occurs when the interface from the dialog manager to 
VSE/ICCF recognizes an *INVALID COMMAND message. This message 
appears in the print buffer from VSE/ICCF under two conditions: 

■1. Dialog manager module DTRDDMIO passes a bad command to VSE/ICCF. 

2. The VSE/ICCF editor drops out of input mode with an error message 
that DTRDDMIO does not recognize. 

In order to discover which condition has occurred, you must have a 
dump available. Directions for getting a dump are in the section 
•ABEND Conditions 1 . 

In the dump, register 2 will point to the *INVALID COMMAND message. 
Register 6 will point at the beginning of the VSE/ICCF print buffer. 
Register 5 will point at the end of the VSE/ICCF print buffer used 
plus 1. Each line in the print buffer is 80 decimal bytes long 

(X'SO 1 ). You should be aware that all 80 bytes contain data from 
VSE/ICCF. Only the first message in each buffer is valid. Normally 
in command mode you will see *READY in each print buffer. In input 
mode each print buffer begins with INP?. In order to find the error 
message, start where register 2 points and go backward 1 print buffer 

(decimal 80 or X^O 1 bytes) at a time. Stop at the address in 
register 6. 

You may also wish to examine the VSE/ICCF input buffer which contains 
the commands and data passed from DTRDDMIO. The input buffer is 
based on register 4. Register 4 plus X'SO 1 is a list of 4 words. 
They contain the following information: 

X^O 1 Address of the beginning of the input buffer 

X f 54 f Address of the end of the input buffer + 1 

X , 58 f Address of the beginning of the print buffer 

X^C 1 Address of the end of the print buffer passed to VSE/ICCF. 
Register 5 is the next byte to be used; this is the last 
byte that can be used + 1. 

The input buffer contains the commands and input to the VSE/ICCF 
editor. The print buffer wraps during this activity. Therefore, it 
is not possible for you to directly correlate print buffers to input 
buffers. You may find a sequence like this in the print buffers: 

• INP7XXXXX.. .XXX 

• INP7XXXXX. . .XXX 

• *EDITOR STACK INVALIDXXXX. . .XXX 
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• *INPUT MODE ENDEDXXXXX...XXX 

• *READYXXXX. ..XXX 

• *INVALID COMMANDXXXX...XXX 

The X»s may be anything. The *INVALID COMMAND caused the DM09. The 
real problem is the error message *EDITOR STACK INVALID. We made up 
this message as an example of an error message that DTRDDMIO would 
not recognize. Once you find this, you can tell whether VSE/ICCF or 
DTRDDMIO has a problem. Either way, you must have a dump to fix this 
problem. 
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APPMDIX C*. SECOBITY AID THE INTERACTIVE PRODOCTJVITI FACILITY 



There are two classes of items which can be made secure under the 
Interactive Productivity Facility: 

1. Interactive Productivity Facility panels, etc, 

2. Your private tables and job streams. 

The Interactive Productivity Facility panels, skeletons, messages, 
and shipped tables all reside in VSE/ICCF libraries 50 through 67. 
Your private tables and job streams reside in your primary library. 

[VH/VSB FEATURE NOTE] The following discussion also applies to 
VM/VSE. For primary library substitute primary minidisk. For 
VSE/ICCF libraries 50 through 67 substitute the minidisk (s) the 
Interactive Productivity Facility is installed on. For private 
library substitute private minidisk, since there is no connect table 
in the VM/VSE environment, ignore all references to the connect table 
if you are using the VM/VSE Feature. 

The system administrator, who is in charge of passwords and VSE/ICCF 
security tables, should always have a primary library which is 
private. Otherwise, other users may gain access to passwords by 
examining the contents of the tables or skeletons which contain that 
information. Other users should also make sure that their primary 
library, which is where the Interactive Productivity Facility dialog 
output will go, is private. This is necessary to protect such items 
as passwords for VSAM data sets which may be contained in output from 
the VSAM define dialogs. The topic 'Protection of Data 1 in the 
VSE/ICCF Instal lation and Operations Reference contains further 
information on this topic. 

It is also possible that you may want certain dialogs to be available 
only to certain users. For example, you may not want anyone except 
the system programmer to have access to the ASI tailoring dialogs. In 
order to do this you have two options, make the library containing 
the ASI items private or move the ASI items to a private library. 

Let us examine the first option. In order to make the library with 
the ASI tailoring items private, we must do the following: 

• Decide which items are ASI tailoring items. 

This information is indirectly given in this manual in the 
section entitled 'Dialogs Listed by Descriptive Title 1 . If we 
examine this list we see that ASI procedure tailoring is listed 
in the descriptive title index. If we look up the ASI procedure 
tailoring dialog, we see that it is named TAS$MAS. The first 
three letters of a dialog are the same as the first three letters 
of the VSE/ICCF items used by the dialog. Now we know that we 
are interested in items with a prefix of TAS. 
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Determine which library these items reside in. 

Now if we go to the section entitled 'User Options Files 1 , 
heading Connect Table , we can see a cross reference of prefix to 
library. We can see that TAS is shipped in library 56 for all 
four types of items. Now we know that if we want to limit access 
to the ASI tailoring dialog, we must make library 56 private. 

Hake sure this library can be private. 

As you can see in Figure 9 on page 159 below which cross 
references library to prefix, there are other items in library 56 
with a prefix of TPW and TRJ. The cross reference of prefix to 
general topic below shows that TPW and TRJ are VSE/POWEF and 
VSE/POWER/RJE tailoring. We probably would want to restrict those 
to the system programmer also, so it looks like we can make 
library 56 private with no harm done to other users. 

However there are some libraries you may not want to make 
private. 

- Library 58 

You may not make library 58 private. The items contained in 
this library are required for the Interactive Productivity 
Facility to run for any user. 

- Library 66 

Library 66 contains the ADM prefixed panels. Some of these 
panels are used in the menu hierarchy to get to dialogs such 
as ASI tailoring* You should not make library 66 private 
unless you are willing to make all dialogs directly selected 
off of the ADM menus private. In order to evaluate this 
question, you should decide which dialogs you are willing to 
leave public. Then select those dialogs under the 
Interactive Productivity Facility beginning from the initial 
menu, DTR$. If you can get to those dialogs without using a 
menu with an ADM prefix, then you can make library 66 
private. 

You will notice that we speak of leaving the ADM prefix 
panels available but not the ADM tables, skeletons, and 
messages. As long as the panels are available, we can get 
from one place to another in the menu hierarchy. However, 
without the tables, skeletons, and message files the dialogs 
which have the ADM prefix may not be run. 

Even if you would normally use an ADM$ menu to get to the 
item, you can still make library 66 private if the dialog is 
not invoked directly off an ADM$ menu. Let us consider a case 
where ADM$ menus are required and where they are not 
required. 
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Once again we will use the example of ASI procedure 
tailoring, this time to show a case where the ADM prefix 
menus are required. There is a cross reference of menu to 
dialog in Appendix B of the Interactive Productivity Facility 
VSE Feature User's G uide * If we look at the cross reference 
by description, we can see that ASI procedure tailoring is 
selected from menu ADM$4. Therefore, in order to get to ASI 
procedure tailoring you must have access to the ADM$ menus. 

Now let us take the case of librarian dialogs. The cross 
reference by description shows that this set of dialogs is 
selected pf f of menu ADM$ to menu LIB$. In this case we can 
circumvent the restriction on ADM$ panels either by telling 
the user to enter =lib$ to fast path select menu LIB$ or by 
adding LIB$ to the environment definition table. In the 
second case we would use the environment definition dialog to 
add menu LIB$ as a selectable environment for that user. Now 
the user must have access to library 57, for ENV items, but 
does not need library 66, for ADM panels. 

- Libraries 55 and 67 

Libraries 55 and 67 contain the SRV prefix members which are 
associated with service. The service dialogs provide some 
common functions such as the restoration of service 
libraries. For example, these functions are invoked by 
supervisor tailoring and VSE/POWER tailoring in order to 
restore service library set A* Therefore, these libraries 
should be available to anyone doing tailoring or similar 
functions. 

• Make the library private. 

This is done using the VSE/ICCF DTSOTIL functions documented in 
the VSE/ICCF Installation and Operation s Reference manual. You 
must alter the library to a status of nopublic. 

The second option we mentioned above was to move the ASI procedure 
tailoring items to a private library. In order to do this you must do 
the following: 

• Find the prefix for ASI tailoring 

You may do this as we did it above, via the dialog descriptions 
section in this manual. 

• Copy all items with this prefix to a private library. 
Let us assume we use library 71. 

• Delete all items with this prefix from the shared library. 

• Modify the connect table entry for this prefix. 
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See the topic Connect Table in the 'User Options Files 1 section 
of this manual for the format of the connect table and how to use 
a modified connect table. In this case we would just change each 
entry for TAS in DTR$DTBL from library 56 to 71. Make sure you 
add the updated DTR$OPT and DTR$DTBL to the primary library of 
each user who needs them. 

You have now moved a single prefix to a private library. 



LIBRARY TO PREFIX CROSS REFEREHCE 



Library Library Prefix and Member Types 

51 ADM messages, skeletons and tables 

52 INS, VER, and DEL panels, messages, skeletons and tables 

53 TCI panels, messages, skeletons and tables 

54 SYI panels, messages, skeletons and tables 

55 SRV messages, skeletons and tables 

56 TAS, TPW, and TRJ panels, messages, skeletons and tables 

57 ENV, TSA, OTA, TEP and TOW 

panels, messages, skeletons and tables. 

58 COS, OPN, DFH, SYM, DBL, PDV, SYO, SOB, ERR, RPT, SNA, 
and DTR panels, messages, skeletons, and tables. 

Any prefix not listed in another library defaults to 58. 

60 AEM, LIB, and OTL panels, messages, skeletons and tables 

61 ELI panels and messages 

62 ELI skeletons and tables 

63 DLZ panels, messages, skeletons and tables 

65 AMS, CAT, DSF and SPC panels, messages, skeletons 
and tables 

66 ADM panels 

67 SRV panels 



Figure 9. Library to prefix cross reference 
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PREFIX TO GENERAL TOPIC CROSS REFERENCE 



Prefix General topic 

ADM General administrator activities, includes some 

tailoring functions, first use, install activities, etc, 

AEM Application Enabling (non System IPO/E product) 

AMS VSAM services master menu 

CAT VSAM service for catalogs 

COS Dialog customize items 

DBL Label items (common service for some dialogs) 

DEL Delete verify items 

DFH CICS/VS tables etc. 

DLZ IMF 

DSF VSAM service for datasets 

DTR Interactive Productivity Facility dialog manager items 

ELI ELIAS (non System IPO/E product) 

ENV Environment definition 

ERR Common error message file 

INS Portions of the install activities 

LIB Librarian services 

OPN JCL build dialog 

PDV Program development under ICCF dialog 

RPT Dump analysis services 

SNA Common message file 

SPC VSAM services for data spaces 

SR? Service 

SUB Job submission items 

SYI Interactive Productivity Facility first time use 

SYM System management 

SYU Master menu for program development 

TAS ASI tailoring 

TCI CICS/VS tailoring 

TEP EP/VS tailoring 

TPW VSE/POWER tailoring 

TRJ VSE/POWER/RJE tailoring 

TSA Supervisor tailoring 

TOW Tailor Otility Workstation (non System IPO/E product) 

OTA Otility aids 

OTL VSE Otilities (Backup/Restore, Fastcopy, etc.) 

VER Portions of the verify activities 



i 



Figure 10. Prefix to general topic cross reference 
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Bote: For further information on the specific dialogs, see the 
•Dialog Descriptions 1 section in this manual. Use the prefix as the 
first three letters of the dialog name to see all dialogs with that 
prefix. Some of the above prefixes include products which are not 
part of the System IPO/E product set. These product dialogs are not 
included in the dialog descriptions section. Also, some common 
services and unique items do not have the same prefix as the 
dialog (s) which use them. 
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deemed appropriate. Comments may be written in your own language; use of English is not required. 

Note: Copies of IBM publications are not stocked at the location to which this form is addressed. 
Please direct any requests for copies of publications, or for assistance in using your IBM system, to 
your IBM representative or to the IBM branch office serving your locality. 
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